$include_dir="/home/hyper-archives/boost-commit/include"; include("$include_dir/msg-header.inc") ?>
From: jurko.gospodnetic_at_[hidden]
Date: 2008-09-02 06:54:10
Author: jurko
Date: 2008-09-02 06:54:08 EDT (Tue, 02 Sep 2008)
New Revision: 48532
URL: http://svn.boost.org/trac/boost/changeset/48532
Log:
Stylistic changes throughout the Boost Jam source base done while researching the Boost Jam internals. No implementation changes.
Text files modified: 
   trunk/tools/jam/src/compile.c |     2                                         
   trunk/tools/jam/src/frames.h  |    40 ++++----                                
   trunk/tools/jam/src/parse.c   |    71 +++++++--------                         
   trunk/tools/jam/src/parse.h   |    66 +++++++-------                          
   trunk/tools/jam/src/scan.c    |   175 +++++++++++++++++++-------------------- 
   trunk/tools/jam/src/scan.h    |    47 +++++-----                              
   6 files changed, 195 insertions(+), 206 deletions(-)
Modified: trunk/tools/jam/src/compile.c
==============================================================================
--- trunk/tools/jam/src/compile.c	(original)
+++ trunk/tools/jam/src/compile.c	2008-09-02 06:54:08 EDT (Tue, 02 Sep 2008)
@@ -532,7 +532,7 @@
     frame_init( inner );
     inner->prev = frame;
     inner->prev_user = frame->module->user_module ? frame : frame->prev_user;
-    inner->module = frame->module; /* This gets fixed up in evaluate_rule(), below */
+    inner->module = frame->module;  /* This gets fixed up in evaluate_rule(), below. */
     inner->procedure = parse;
     for ( p = parse->left; p; p = p->left )
         lol_add( inner->args, parse_evaluate( p->right, frame ) );
Modified: trunk/tools/jam/src/frames.h
==============================================================================
--- trunk/tools/jam/src/frames.h	(original)
+++ trunk/tools/jam/src/frames.h	2008-09-02 06:54:08 EDT (Tue, 02 Sep 2008)
@@ -4,36 +4,34 @@
  *  (See accompanying file LICENSE_1_0.txt or http://www.boost.org/LICENSE_1_0.txt)
  */
 #ifndef FRAMES_DWA20011021_H
-# define FRAMES_DWA20011021_H
+#define FRAMES_DWA20011021_H
 
-# include "lists.h"
-# include "modules.h"
+#include "lists.h"
+#include "modules.h"
 
 typedef struct _PARSE PARSE;
 typedef struct frame FRAME;
 
 struct frame
 {
-    FRAME* prev;
-    /** The nearest enclosing frame for which module->user_module is
-        true. */
-    FRAME* prev_user;
-    LOL args[1];
-    module_t* module;
-    PARSE* procedure;
-    char*  rulename;
+    FRAME    * prev;
+    /* The nearest enclosing frame for which module->user_module is true. */
+    FRAME    * prev_user;
+    LOL        args[ 1 ];
+    module_t * module;
+    PARSE    * procedure;
+    char     * rulename;
 };
 
-/* When call into Python is in progress, this
-   variable points to the bjam frame that
-   was current at the moment of call.  When the call
-   completes, the variable is not defined.  Further,
-   if Jam calls Python which calls Jam and so on,
-   this variable only keeps the most recent Jam frame.  */
-extern struct frame *frame_before_python_call;
 
-void frame_init( FRAME* ); /* implemented in compile.c */
-void frame_free( FRAME* ); /* implemented in compile.c */
+/* When call into Python is in progress, this variable points to the bjam frame
+ * that was current at the moment of call. When the call completes, the variable
+ * is not defined. Further, if Jam calls Python which calls Jam and so on, this
+ * variable only keeps the most recent Jam frame.
+ */
+extern struct frame * frame_before_python_call;
 
-#endif
+void frame_init( FRAME * );  /* implemented in compile.c */
+void frame_free( FRAME * );  /* implemented in compile.c */
 
+#endif
Modified: trunk/tools/jam/src/parse.c
==============================================================================
--- trunk/tools/jam/src/parse.c	(original)
+++ trunk/tools/jam/src/parse.c	2008-09-02 06:54:08 EDT (Tue, 02 Sep 2008)
@@ -10,13 +10,13 @@
  *  (See accompanying file LICENSE_1_0.txt or http://www.boost.org/LICENSE_1_0.txt)
  */
 
-# include "jam.h"
-# include "lists.h"
-# include "parse.h"
-# include "scan.h"
-# include "newstr.h"
-# include "modules.h"
-# include "frames.h"
+#include "jam.h"
+#include "lists.h"
+#include "parse.h"
+#include "scan.h"
+#include "newstr.h"
+#include "modules.h"
+#include "frames.h"
 
 /*
  * parse.c - make and destroy parse trees as driven by the parser
@@ -27,23 +27,20 @@
  *      returns a LIST *.
  */
 
-static PARSE *yypsave;
+static PARSE * yypsave;
 
-void
-parse_file( char *f, FRAME* frame )
+void parse_file( char * f, FRAME * frame )
 {
-    /* Suspend scan of current file */
-    /* and push this new file in the stream */
-
+    /* Suspend scan of current file and push this new file in the stream. */
     yyfparse( f );
 
-    /* Now parse each block of rules and execute it. */
-    /* Execute it outside of the parser so that recursive */
-    /* calls to yyrun() work (no recursive yyparse's). */
+    /* Now parse each block of rules and execute it. Execute it outside of the
+     * parser so that recursive calls to yyrun() work (no recursive yyparse's).
+     */
 
     for ( ; ; )
     {
-        PARSE *p;
+        PARSE * p;
 
         /* Filled by yyparse() calling parse_save(). */
         yypsave = 0;
@@ -66,15 +63,15 @@
 
 
 PARSE * parse_make(
-    LIST    *(*func)( PARSE *p, FRAME *args ),
-    PARSE   *left,
-    PARSE   *right,
-    PARSE   *third,
-    char    *string,
-    char    *string1,
-    int num )
+    LIST  * (* func)( PARSE *, FRAME * ),
+    PARSE * left,
+    PARSE * right,
+    PARSE * third,
+    char  * string,
+    char  * string1,
+    int     num )
 {
-    PARSE   *p = (PARSE *)BJAM_MALLOC( sizeof( PARSE ) );
+    PARSE * p = (PARSE *)BJAM_MALLOC( sizeof( PARSE ) );
 
     p->func = func;
     p->left = left;
@@ -84,23 +81,23 @@
     p->string1 = string1;
     p->num = num;
     p->refs = 1;
-        p->rulename = 0;
+    p->rulename = 0;
 
-        if ( left )
-        {
-            p->file = left->file;
-            p->line = left->line;
-        }
-        else
-        {
-            yyinput_stream( &p->file, &p->line );
-        }
+    if ( left )
+    {
+        p->file = left->file;
+        p->line = left->line;
+    }
+    else
+    {
+        yyinput_stream( &p->file, &p->line );
+    }
 
     return p;
 }
 
-void
-parse_refer( PARSE *p )
+
+void parse_refer( PARSE * p )
 {
     ++p->refs;
 }
Modified: trunk/tools/jam/src/parse.h
==============================================================================
--- trunk/tools/jam/src/parse.h	(original)
+++ trunk/tools/jam/src/parse.h	2008-09-02 06:54:08 EDT (Tue, 02 Sep 2008)
@@ -4,56 +4,56 @@
  * This file is part of Jam - see jam.c for Copyright information.
  */
 
-/*  This file is ALSO:
- *  Copyright 2001-2004 David Abrahams.
- *  Distributed under the Boost Software License, Version 1.0.
- *  (See accompanying file LICENSE_1_0.txt or http://www.boost.org/LICENSE_1_0.txt)
+/* This file is ALSO:
+ * Copyright 2001-2004 David Abrahams.
+ * Distributed under the Boost Software License, Version 1.0.
+ * (See accompanying file LICENSE_1_0.txt or http://www.boost.org/LICENSE_1_0.txt)
  */
 
 #ifndef PARSE_DWA20011020_H
-# define PARSE_DWA20011020_H
-# include "frames.h"
-# include "modules.h"
-# include "lists.h"
+#define PARSE_DWA20011020_H
+
+#include "frames.h"
+#include "modules.h"
+#include "lists.h"
 
 /*
- * parse.h - make and destroy parse trees as driven by the parser
+ * parse.h - make and destroy parse trees as driven by the parser.
  */
 
 /*
- * parse tree node
+ * Parse tree node.
  */
 
 struct _PARSE {
-    LIST    *(*func)( PARSE *p, FRAME *frame );
-    PARSE   *left;
-    PARSE   *right;
-    PARSE   *third;
-    char    *string;
-    char    *string1;
+    LIST   * (* func)( PARSE *, FRAME * );
+    PARSE  * left;
+    PARSE  * right;
+    PARSE  * third;
+    char   * string;
+    char   * string1;
     int      num;
     int      refs;
-/*    module*  module; */
-    char*    rulename;
-    char*    file;
+/*  module * module; */
+    char   * rulename;
+    char   * file;
     int      line;
 };
 
-void    parse_file( char *f, FRAME* frame );
-void    parse_save( PARSE *p );
+void    parse_file( char *, FRAME * );
+void    parse_save( PARSE * );
 
 PARSE * parse_make(
-    LIST    *(*func)( PARSE *p, FRAME* frame ),
-    PARSE   *left,
-    PARSE   *right,
-    PARSE   *third,
-    char    *string,
-    char    *string1,
-    int      num );
-
-void    parse_refer( PARSE *p );
-void    parse_free( PARSE *p );
-LIST*   parse_evaluate( PARSE *p, FRAME* frame );
+    LIST  * (* func)( PARSE *, FRAME * ),
+    PARSE * left,
+    PARSE * right,
+    PARSE * third,
+    char  * string,
+    char  * string1,
+    int     num );
+
+void   parse_refer   ( PARSE * );
+void   parse_free    ( PARSE * );
+LIST * parse_evaluate( PARSE *, FRAME * );
 
 #endif
-
Modified: trunk/tools/jam/src/scan.c
==============================================================================
--- trunk/tools/jam/src/scan.c	(original)
+++ trunk/tools/jam/src/scan.c	2008-09-02 06:54:08 EDT (Tue, 02 Sep 2008)
@@ -4,13 +4,13 @@
  * This file is part of Jam - see jam.c for Copyright information.
  */
 
-# include "jam.h"
-# include "lists.h"
-# include "parse.h"
-# include "scan.h"
-# include "jamgram.h"
-# include "jambase.h"
-# include "newstr.h"
+#include "jam.h"
+#include "lists.h"
+#include "parse.h"
+#include "scan.h"
+#include "jamgram.h"
+#include "jambase.h"
+#include "newstr.h"
 
 /*
  * scan.c - the jam yacc scanner
@@ -50,13 +50,15 @@
 
 static int scanmode = SCAN_NORMAL;
 static int anyerrors = 0;
+
+
 static char * symdump( YYSTYPE * );
 
-# define BIGGEST_TOKEN 10240    /* no single token can be larger */
+#define BIGGEST_TOKEN 10240  /* no single token can be larger */
 
 
 /*
- * Set parser mode: normal, string, or keyword
+ * Set parser mode: normal, string, or keyword.
  */
 
 void yymode( int n )
@@ -64,8 +66,8 @@
     scanmode = n;
 }
 
-void
-yyerror( char *s )
+
+void yyerror( char * s )
 {
     if ( incp )
         printf( "%s:%d: ", incp->fname, incp->line );
@@ -75,19 +77,18 @@
     ++anyerrors;
 }
 
-int
-yyanyerrors()
+
+int yyanyerrors()
 {
     return anyerrors != 0;
 }
 
-void
-yyfparse( char *s )
+
+void yyfparse( char * s )
 {
-    struct include *i = (struct include *)BJAM_MALLOC( sizeof( *i ) );
+    struct include * i = (struct include *)BJAM_MALLOC( sizeof( *i ) );
 
     /* Push this onto the incp chain. */
-
     i->string = "";
     i->strings = 0;
     i->file = 0;
@@ -97,76 +98,72 @@
     incp = i;
 
     /* If the filename is "+", it means use the internal jambase. */
-
     if ( !strcmp( s, "+" ) )
         i->strings = jambase;
 }
 
+
 /*
- * yyline() - read new line and return first character
+ * yyline() - read new line and return first character.
  *
- * Fabricates a continuous stream of characters across include files,
- * returning EOF at the bitter end.
+ * Fabricates a continuous stream of characters across include files, returning
+ * EOF at the bitter end.
  */
 
-int
-yyline()
+int yyline()
 {
-    struct include *i = incp;
+    struct include * i = incp;
 
     if ( !incp )
         return EOF;
 
-    /* Once we start reading from the input stream, we reset the */
-    /* include insertion point so that the next include file becomes */
-    /* the head of the list. */
+    /* Once we start reading from the input stream, we reset the include
+     * insertion point so that the next include file becomes the head of the
+     * list.
+     */
 
     /* If there is more data in this line, return it. */
-
     if ( *i->string )
         return *i->string++;
 
-    /* If we're reading from an internal string list, go to the */
-    /* next string. */
-
+    /* If we are reading from an internal string list, go to the next string. */
     if ( i->strings )
     {
         if ( !*i->strings )
             goto next;
 
-        i->line++;
+        ++i->line;
         i->string = *(i->strings++);
         return *i->string++;
     }
 
-    /* If necessary, open the file */
-
+    /* If necessary, open the file. */
     if ( !i->file )
     {
         FILE * f = stdin;
         if ( strcmp( i->fname, "-" ) && !( f = fopen( i->fname, "r" ) ) )
-         perror( i->fname );
+            perror( i->fname );
         i->file = f;
     }
 
-    /* If there's another line in this file, start it. */
-
+    /* If there is another line in this file, start it. */
     if ( i->file && fgets( i->buf, sizeof( i->buf ), i->file ) )
     {
-        i->line++;
+        ++i->line;
         i->string = i->buf;
         return *i->string++;
     }
 
     next:
-    /* This include is done.  */
-    /* Free it up and return EOF so yyparse() returns to parse_file(). */
 
-    incp = i->next;
+    /* This include is done. Free it up and return EOF so yyparse() returns to
+     * parse_file().
+     */
 
-    /* Close file, free name */
+    incp = i->next;
 
-    if ( i->file && i->file != stdin )
+    /* Close file, free name. */
+    if ( i->file && ( i->file != stdin ) )
         fclose( i->file );
     freestr( i->fname );
     BJAM_FREE( (char *)i );
@@ -174,20 +171,21 @@
     return EOF;
 }
 
+
 /*
- * yylex() - set yylval to current token; return its type
+ * yylex() - set yylval to current token; return its type.
  *
  * Macros to move things along:
  *
- *  yychar() - return and advance character; invalid after EOF
- *  yyprev() - back up one character; invalid before yychar()
+ *  yychar() - return and advance character; invalid after EOF.
+ *  yyprev() - back up one character; invalid before yychar().
  *
- * yychar() returns a continuous stream of characters, until it hits
- * the EOF of the current include file.
+ * yychar() returns a continuous stream of characters, until it hits the EOF of
+ * the current include file.
  */
 
-# define yychar() ( *incp->string ? *incp->string++ : yyline() )
-# define yyprev() ( incp->string-- )
+#define yychar() ( *incp->string ? *incp->string++ : yyline() )
+#define yyprev() ( incp->string-- )
 
 int yylex()
 {
@@ -198,21 +196,21 @@
     if ( !incp )
         goto eof;
 
-    /* Get first character (whitespace or of token) */
-
+    /* Get first character (whitespace or of token). */
     c = yychar();
 
     if ( scanmode == SCAN_STRING )
     {
-        /* If scanning for a string (action's {}'s), look for the */
-        /* closing brace.  We handle matching braces, if they match! */
+        /* If scanning for a string (action's {}'s), look for the closing brace.
+         * We handle matching braces, if they match.
+         */
 
         int nest = 1;
 
-        while ( c != EOF && b < ( buf + sizeof( buf ) ) )
+        while ( ( c != EOF ) && ( b < buf + sizeof( buf ) ) )
         {
             if ( c == '{' )
-                nest++;
+                ++nest;
 
             if ( ( c == '}' ) && !--nest )
                 break;
@@ -230,8 +228,7 @@
         if ( c != EOF )
             yyprev();
 
-        /* Check obvious errors. */
-
+        /* Check for obvious errors. */
         if ( b == buf + sizeof( buf ) )
         {
             yyerror( "action block too big" );
@@ -244,12 +241,11 @@
             goto eof;
         }
 
-        * b = 0;
+        *b = 0;
         yylval.type = STRING;
         yylval.string = newstr( buf );
         yylval.file = incp->fname;
         yylval.line = incp->line;
-
     }
     else
     {
@@ -258,37 +254,36 @@
         int inquote = 0;
         int notkeyword;
 
-        /* Eat white space */
-
+        /* Eat white space. */
         for ( ;; )
         {
             /* Skip past white space. */
             while ( ( c != EOF ) && isspace( c ) )
                 c = yychar();
 
-            /* Not a comment?  Swallow up comment line. */
+            /* Not a comment? */
             if ( c != '#' )
                 break;
+
+            /* Swallow up comment line. */
             while ( ( ( c = yychar() ) != EOF ) && ( c != '\n' ) ) ;
         }
 
         /* c now points to the first character of a token. */
-
         if ( c == EOF )
             goto eof;
 
         yylval.file = incp->fname;
         yylval.line = incp->line;
 
-        /* While scanning the word, disqualify it for (expensive) */
-        /* keyword lookup when we can: $anything, "anything", \anything */
-
+        /* While scanning the word, disqualify it for (expensive) keyword lookup
+         * when we can: $anything, "anything", \anything
+         */
         notkeyword = c == '$';
 
-        /* look for white space to delimit word */
-        /* "'s get stripped but preserve white space */
-        /* \ protects next character */
-
+        /* Look for white space to delimit word. "'s get stripped but preserve
+         * white space. \ protects next character.
+         */
         while
         (
             ( c != EOF ) &&
@@ -307,7 +302,7 @@
                 /* normal char */
                 *b++ = c;
             }
-            else if ( ( c = yychar()) != EOF )
+            else if ( ( c = yychar() ) != EOF )
             {
                 /* \c */
                 *b++ = c;
@@ -323,44 +318,40 @@
         }
 
         /* Check obvious errors. */
-
         if ( b == buf + sizeof( buf ) )
         {
-        yyerror( "string too big" );
-        goto eof;
+            yyerror( "string too big" );
+            goto eof;
         }
 
         if ( inquote )
         {
-        yyerror( "unmatched \" in string" );
-        goto eof;
+            yyerror( "unmatched \" in string" );
+            goto eof;
         }
 
         /* We looked ahead a character - back up. */
-
         if ( c != EOF )
-        yyprev();
+            yyprev();
 
-        /* scan token table */
-        /* don't scan if it's obviously not a keyword or if its */
-        /* an alphabetic when were looking for punctuation */
+        /* Scan token table. Do not scan if it is obviously not a keyword or if
+         * it is an alphabetic when were looking for punctuation.
+         */
 
         *b = 0;
         yylval.type = ARG;
 
-        if ( !notkeyword && !( isalpha( *buf ) && scanmode == SCAN_PUNCT ) )
-        {
+        if ( !notkeyword && !( isalpha( *buf ) && ( scanmode == SCAN_PUNCT ) ) )
             for ( k = keywords; k->word; ++k )
                 if ( ( *buf == *k->word ) && !strcmp( k->word, buf ) )
-                {
+                { 
                     yylval.type = k->type;
                     yylval.string = k->word;  /* used by symdump */
                     break;
                 }
-        }
 
         if ( yylval.type == ARG )
-        yylval.string = newstr( buf );
+            yylval.string = newstr( buf );
     }
 
     if ( DEBUG_SCAN )
@@ -376,8 +367,8 @@
     return yylval.type;
 }
 
-static char *
-symdump( YYSTYPE *s )
+
+static char * symdump( YYSTYPE * s )
 {
     static char buf[ BIGGEST_TOKEN + 20 ];
     switch ( s->type )
@@ -392,9 +383,11 @@
 }
 
 
-/*  Get information about the current file and line, for those epsilon
- *  transitions that produce a parse.
+/*
+ * Get information about the current file and line, for those epsilon
+ * transitions that produce a parse.
  */
+
 void yyinput_stream( char * * name, int * line )
 {
     if ( incp )
Modified: trunk/tools/jam/src/scan.h
==============================================================================
--- trunk/tools/jam/src/scan.h	(original)
+++ trunk/tools/jam/src/scan.h	2008-09-02 06:54:08 EDT (Tue, 02 Sep 2008)
@@ -9,47 +9,48 @@
  *
  * External functions:
  *
- *  yyerror( char *s ) - print a parsing error message
- *  yyfparse( char *s ) - scan include file s
- *  yylex() - parse the next token, returning its type
- *  yymode() - adjust lexicon of scanner
- *  yyparse() - declaration for yacc parser
- *  yyanyerrors() - indicate if any parsing errors occured
+ *  yyerror( char *s ) - print a parsing error message.
+ *  yyfparse( char *s ) - scan include file s.
+ *  yylex() - parse the next token, returning its type.
+ *  yymode() - adjust lexicon of scanner.
+ *  yyparse() - declaration for yacc parser.
+ *  yyanyerrors() - indicate if any parsing errors occured.
  *
- * The yymode() function is for the parser to adjust the lexicon of the
- * scanner.  Aside from normal keyword scanning, there is a mode to
- * handle action strings (look only for the closing }) and a mode to
- * ignore most keywords when looking for a punctuation keyword.  This
- * allows non-punctuation keywords to be used in lists without quoting.
+ * The yymode() function is for the parser to adjust the lexicon of the scanner.
+ * Aside from normal keyword scanning, there is a mode to handle action strings
+ * (look only for the closing }) and a mode to ignore most keywords when looking
+ * for a punctuation keyword. This allows non-punctuation keywords to be used in
+ * lists without quoting.
  */
 
 /*
  * YYSTYPE - value of a lexical token
  */
 
-# define YYSTYPE YYSYMBOL
+#define YYSTYPE YYSYMBOL
 
-typedef struct _YYSTYPE {
+typedef struct _YYSTYPE
+{
     int     type;
-    char    *string;
-    PARSE   *parse;
-    LIST    *list;
+    char  * string;
+    PARSE * parse;
+    LIST  * list;
     int     number;
-    char    *file;
+    char  * file;
     int     line;
 } YYSTYPE;
 
 extern YYSTYPE yylval;
 
 void yymode( int n );
-void yyerror( char *s );
+void yyerror( char * s );
 int yyanyerrors();
-void yyfparse( char *s );
+void yyfparse( char * s );
 int yyline();
 int yylex();
 int yyparse();
-void yyinput_stream( char** name, int* line );
+void yyinput_stream( char * * name, int * line );
 
-# define SCAN_NORMAL    0   /* normal parsing */
-# define SCAN_STRING    1   /* look only for matching } */
-# define SCAN_PUNCT 2   /* only punctuation keywords */
+# define SCAN_NORMAL  0   /* normal parsing */
+# define SCAN_STRING  1   /* look only for matching } */
+# define SCAN_PUNCT   2   /* only punctuation keywords */