Aquileo | Recent changes to bugs

Aquileo | #138 Incorrect rendering of function declaration with default arguments

2015-11-13T04:26:46.352000Z

status: open --> closed

Aquileo | #138 Incorrect rendering of function declaration with default arguments

2015-11-10T22:45:58.790000Z

Open [ND Dir]\Modules\NaturalDocs\Builder\HTMLBase.pm

Search for "$param->DefaultValue()"

In the first instance of it, change "if ($param->DefaultValue())" to "if (defined $param->DefaultValue())"

Run Natural Docs with -r once to apply the changes everywhere.

Aquileo | Incorrect rendering of function declaration with default arguments

2015-11-04T16:12:48.377000Z

A simple C++ function declaration like this:

void foo(int a, int b=0)

is rendered as

void foo(int a,
int b = )

in Natural Docs html output. By contrast,

void foo(int a, int b = 0)

is rendered as one would expect.

Results obtained using NaturalDocs 1.51 in Ubuntu 15.10.

Aquileo | Incorrect rendering of function declaration with default arguments

2015-11-04T16:12:48.377000Z

Ticket 138 has been modified: Incorrect rendering of function declaration with default arguments
Edited By: Greg Valure (gregvalure)
Status updated: u'open' => u'closed'

Aquileo | #137 Can't locate NaturalDocs/Constants.pm

2015-01-13T16:43:18.408000Z

Try adding -I[Modules folder], like this:

perl -I"%userprofile%\Desktop\Doc\Modules" "%userprofile%\Desktop\Doc\NaturalDocs"

Aquileo | Can't locate NaturalDocs/Constants.pm

2015-01-13T00:00:27.898000Z

Hi;
I had the “Can’t open perl script NaturalDocs” massage, so i changed the path like in the troubleshooting article in the bat file. Now when i'm starting NaturalDocs.bat via cmd this
error occurs.

C:\Users\$User\Desktop\Doc\NaturalDocs.bat
Can't locate NaturalDocs/Constants.pm in @INC (@INC contains: /c/Users/$User/Mod
ules /usr/lib/perl5/5.8.8/msys /usr/lib/perl5/5.8.8 /usr/lib/perl5/site_perl/5.8.8/msys /usr/lib/perl5/site_perl/5.8.8 /usr/lib/perl5/site_perl .) at C:\Users\$User\Desktop\Doc\NaturalDocs line 61.

BEGIN failed--compilation aborted at C:\Users\$User\Desktop\Doc\NaturalDocs line 61.

Aquileo | "Unexpected at this time" error during generation

2013-08-17T23:03:38.719000Z

Running NaturalDocs for the first time generated the following error:

c:\Program Files\NaturalDocs>NaturalDocs.bat -i "C:\inetpub\wwwroot\accsys-framework-ui" -o HTML "C:\inetpub\wwwroot\accsys-framework-ui_help" -p "C:\Program Files\NaturalDocs\Projects\accsys-framework-ui"
Files\NaturalDocs\Projects\accsys-framework-ui""=="" was unexpected at this time.

This was with:
Natural Docs 1.52
ActivePerl 5.6.13 x64
* Windows 8 x64

Fix:
Changed:

if "%1"=="" goto NOMORE
to:
if [%1]==[] goto NOMORE

Based on http://stackoverflow.com/questions/2541767/what-is-the-proper-way-to-test-is-variable-is-empty-in-a-batch-file-if-not-1

Aquileo | Errors in the command line causes error mesage and zero exit status

2013-07-04T11:03:55.644000Z

If there are errors in the command line, NaturalDocs prints error message (that's right) and exits with status zero, which is wrong, because zero exit status means "success".

The problem is in Settings.pm:

1169      if (scalar @errorMessages)
1170          {
1171          print join("\n", @errorMessages) . "\nType NaturalDocs -h to see the syntax reference.\n";
1172          exit;
1173          };
1174      };

Line 1172 should be:

1172          exit 1;

Exit status may be any (unless it documented) but non-zero.

Patch is attached.

Aquileo | Extending NaturalDocs with custom Perl modules does not work

2013-07-04T08:46:52.810000Z

Languages.txt has a comment:

# Perl Package: [perl package]
#    Specifies the Perl package used to fine-tune the language behavior in ways
#    too complex to do in this file.

I have added following lines to my Languages.txt:

Language: SomeLang

   Extension: sl
   Perl Package: SomeLang

But NaturalDocs issues an error:

NaturalDocs:.../Languages.txt:132: could not create NaturalDocs::Languages::Test object
Natural Docs encountered the following error and was stopped:
   There is an error in .../Languages.txt

Investigation shows that problem is in Languages.pm:

478             elsif ($keyword eq 'perl package')
479                 {
480                 eval
481                     {
482                     $language = $value->New($languageName);
483                     };
484                 if ($::EVAL_ERROR)
485                     {
486                     NaturalDocs::ConfigFile->AddError('Could not create ' . $value . ' object.', $lineNumber);
487                     return;
488                     };
489                 };
490             };

All the modules shipped with NaturalDocs are "use"d at the top of the file, so $value->New($languageName) works ok. But custom module is not loaded. NaturalDocs should load a module before calling its New method:

478             elsif ($keyword eq 'perl package')
479                 {
+++                 eval "require $value;" and  # NOTE THIS LINE
480                 eval
481                     {
482                     $language = $value->New($languageName);
483                     };
484                 if ($::EVAL_ERROR)
485                     {
486                     NaturalDocs::ConfigFile->AddError('Could not create ' . $value . ' object.', $lineNumber);
487                     return;
488                     };
489                 };
490             };

The patch is attached.

Aquileo | #133 Round brackets in named link urls causes parsing problems

2012-12-17T19:43:35.623000Z

That works very well, thank-you.

FYI: on page 15 of http://www.w3.org/Addressing/URL/url-spec.txt,
a path segment is defined (BNF) to include the following:
safe $ | - | _ | @ | . | & | + | -
extra ! | * | " | ' | ( | ) | ,

so a patch should probably also a add the dollar sign and exclamation mark.