pjs/js2/README

Build instructions from pschwartau@netscape.com as of 2 Dec 2001 ...

Building JS2 on WINNT:
---------------------------------------------------------------------------------------------
[/d/JS_2] cvs -z3 co mozilla/js2
          cvs -z3 co mozilla/js/src/fdlibm

In Visual C++:

Workspace:    D:\JS_2\mozilla\js2\src\winbuild\dikdik.dsw

Project Files:   D:\JS_2\mozilla\js2\src\winbuild\DikDik.dsp
                 D:\JS_2\mozilla\js2\tests\cpp\winbuild\DikDik_shell.dsp  <---------- active project
                 D:\JS_2\mozilla\js2\src\winbuild\fdlibm.dsp


RUNNING THE JS2 SHELL AFTER YOU'VE BUILT IT:
(Note the 3 underbars between "shell" and "Win32" in "DikDik_shell___Win32_Debug")                      [/d/JS_2/mozilla/js2/tests/cpp/winbuild/DikDik_shell___Win32_Debug] ./DikDik_shell.exe



Building JS2 on LINUX:
---------------------------------------------------------------------------------------------
[/d/JS_2] cvs -z3 co mozilla/js2
               cvs -z3 co mozilla/js/src/fdlibm

[/d/JS_2] cd mozilla/js2

[/d/JS_2/mozilla/js2] automake    <--- FIRST TIME ONLY
[/d/JS_2/mozilla/js2] autoconf      <--- FIRST TIME ONLY
[/d/JS_2/mozilla/js2] ./configure --enable-debug     <--- FIRST TIME ONLY
[/d/JS_2/mozilla/js2] make



Building JS2 on MAC 9.1
---------------------------------------------------------------------------------------------
Get updated CodeWarrior Pro 7 tools !

Open (path to):mozilla:js2:tests:cpp:macbuild:js2_shell.mcp and build it.
There is also (path to ):mozilla:js2:tests:cpp:macbuild:parser_test.mcp, if you just want to try out the full parser
without getting complaints about unimplemented features from the back end.




/***************************************************************************/
// The stuff below looks pretty out of date to me.
// I wonder if it shouldn't just be removed

parse functions
    parseIdentifierQualifiers(ExprNode *e, bool &foundQualifiers,
    parseParenthesesAndIdentifierQualifiers(const Token &tParen,
    parseQualifiedIdentifier(const Token &t, bool preferRegExp)
    parseArrayLiteral(const Token &initialToken)
    parseObjectLiteral(const Token &initialToken)
    parsePrimaryExpression()
    parseMember(ExprNode *target, const Token &tOperator,
    parseInvoke(ExprNode *target, uint32 pos,
    parsePostfixExpression(bool newExpression)
    parseUnaryExpression()
    parseExpression(bool noIn, bool noAssignment, bool noComma)
    parseParenthesizedExpression()
    parseTypeExpression(bool noIn)
    parseTypedIdentifier(ExprNode *&type)
    parseTypeBinding(Token::Kind kind, bool noIn)
    parseTypeListBinding(Token::Kind kind)
    parseVariableBinding(bool noQualifiers, bool noIn)
    parseFunctionName(FunctionName &fn)
    parseFunctionSignature(FunctionDefinition &fd)
    parseBlock(bool inSwitch, bool noCloseBrace)
    parseBody(SemicolonState *semicolonState)
    parseAttributeStatement(uint32 pos, IdentifierList *attributes,
    parseAttributesAndStatement(const Token *t, AttributeStatement as,
    parseAnnotatedBlock()
    parseFor(uint32 pos, SemicolonState &semicolonState)
    parseTry(uint32 pos)
    parseStatement(bool /*topLevel*/, bool inSwitch,
    parseStatementAndSemicolon(SemicolonState &semicolonState)
    parseIdentifier()
    parseLiteralField()
    parseFieldName()
    parseArgumentList(NodeQueue<ExprPairList> &args)
    parseArgumentListPrime(NodeQueue<ExprPairList> &args)
    parseNamedArgumentListPrime(NodeQueue<ExprPairList> &args)
    parseAllParameters(FunctionDefinition &fd,
    parseOptionalNamedRestParameters (FunctionDefinition &fd,
    parseNamedRestParameters(FunctionDefinition &fd,
    parseNamedParameters(FunctionDefinition &fd,
    parseRestParameter()
    parseParameter()
    parseOptionalParameter()
    parseOptionalParameterPrime(VariableBinding *first)
    parseNamedParameter(NodeQueue<IdentifierList> &aliases)
    parseResultSignature()


1/28/01

Files:

cpucfg.h

formatter.cpp formatter.h
"Formatter" class, iostream like wrapper around stdio.

gc_allocator.h, gc_container.h
boehm gc stuff.

hash.cpp hash.h
a hash

lexer.cpp lexer.h
main lexer.

mem.cpp mem.h
zone, arena, and pool classes for memory management.

nodefactory.h
parse node factory.

numerics.cpp numerics.h
numbers and stuff.

parser.cpp parser.h
main parser source.
tables in parser.h: 
    enum ExprNode::Kind; types of expressions
    enum StmtNode::Kind; types of statements


reader.cpp reader.h
"Reader" class, feeds source to the parser/lexer.

stlcfg.h
stupid stl tricks
.
systemtypes.h
basic typedefs.

token.cpp token.h
token class.

utilities.cpp utilities.h
random things.

world.cpp world.h
the whole world.