townforge/build
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Add block comments to jam language.

Browse Source 
This adds non-nested block comments wrapped with "#*" and "*#". This
should help in cleaning up embedded documentation and generally make
writing jam code easier.
This commit is contained in:
Rene Rivera 2017-07-27 08:55:44 -05:00
parent 1932313f47
commit edc18ece12
3 changed files with 24 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
doc/bjam.qbk
View File

@ -393,7 +393,7 @@ The arguments starting with the "=--option=" forms are passed to the =build.jam=
must be quoted with double quotes (") to be used as arbitrary tokens, such as
variable or target names.
Comments start with the [^#] character and extend until the end of line.
Comments start with the [^#] character and extend until the end of line. And block comments start with [^#*] and extend until the next [^*#].
[endsect]

8
example/time/jamroot.jam
View File

@ -1,6 +1,8 @@
# Distributed under the Boost Software License, Version 1.0. (See
# accompanying file LICENSE_1_0.txt or copy at
# http://www.boost.org/LICENSE_1_0.txt)
#*
Distributed under the Boost Software License, Version 1.0. (See
accompanying file LICENSE_1_0.txt or copy at
http://www.boost.org/LICENSE_1_0.txt)
*#
#[jamroot
#<< Import the time rule from the testing module.

20
src/engine/scan.c
View File

@ -283,8 +283,24 @@ int yylex()
if ( c != '#' )
break;
/* Swallow up comment line. */
while ( ( ( c = yychar() ) != EOF ) && ( c != '\n' ) ) ;
c = yychar();
if ( ( c != EOF ) && c == '*' )
{
/* Swallow up block comment. */
int c0 = yychar();
int c1 = yychar();
while ( ! ( c0 == '*' && c1 == '#' ) && ( c0 != EOF && c1 != EOF ) )
{
c0 = c1;
c1 = yychar();
}
c = c1;
}
else
{
/* Swallow up comment line. */
while ( ( c != EOF ) && ( c != '\n' ) ) c = yychar();
}
}
/* c now points to the first character of a token. */