1
0
Fork 0

Merge branch 'master' into doc/master

Conflicts:
	Makefile
closure/master
Mike Gerwitz 2011-03-11 19:56:23 -05:00
commit c1ddca1a3d
2 changed files with 69 additions and 61 deletions

View File

@ -17,6 +17,9 @@ PATH_MANUAL_TEXI=${PATH_DOC}/manual.texi
COMBINE=${PATH_TOOLS}/combine COMBINE=${PATH_TOOLS}/combine
TESTS_JS := $(shell find "./test" -name 'test-*.js')
TESTS_SHELL := $(shell find "./test" -name 'test-[^\.]*')
.PHONY: test doc .PHONY: test doc
@ -26,23 +29,21 @@ all: combine doc
# create build dir # create build dir
mkbuild: mkbuild:
@mkdir -p "${PATH_BUILD}" mkdir -p "${PATH_BUILD}"
# combine all modules into easily redistributable ease.js file (intended for # combine all modules into easily redistributable ease.js file (intended for
# browser) # browser)
combine: mkbuild combine: mkbuild
${COMBINE} > "${PATH_COMBINE_OUTPUT}" ${COMBINE} > "${PATH_COMBINE_OUTPUT}"
INC_TEST=1 "${COMBINE}" > "${PATH_COMBINE_OUTPUT_FULL}" INC_TEST=1 "${COMBINE}" > "${PATH_COMBINE_OUTPUT_FULL}"
@cp "${PATH_BROWSER_TEST}" "${PATH_BUILD}" cp "${PATH_BROWSER_TEST}" "${PATH_BUILD}"
# run tests # run tests
test: default test: default $(TESTS_JS) $(TESTS_SHELL)
for test in `find ./test -name 'test-*.js'`; do \ test-%.js: default
node $${test}; \ node $@
done; \ test-%: default
for test in `find ./test -regex '.*/test-[^\.]*'`; do \ ./$@
./$$test; \
done;
# generate texinfo documentation (twice to generate TOC), then remove the extra # generate texinfo documentation (twice to generate TOC), then remove the extra
# files that were generated # files that were generated
@ -57,7 +58,7 @@ doc: mkbuild
! -name '*.pdf' -a \ ! -name '*.pdf' -a \
! -name '*.css' \ ! -name '*.css' \
| xargs rm | xargs rm
@mv -f "${PATH_DOC}"/*.pdf "${PATH_DOC_OUTPUT}" mv -f "${PATH_DOC}"/*.pdf "${PATH_DOC_OUTPUT}"
cd "${PATH_DOC}"; \ cd "${PATH_DOC}"; \
makeinfo -o "${PATH_DOC_OUTPUT_INFO}" "${PATH_MANUAL_TEXI}"; \ makeinfo -o "${PATH_DOC_OUTPUT_INFO}" "${PATH_MANUAL_TEXI}"; \
makeinfo --plain "${PATH_MANUAL_TEXI}" > "${PATH_DOC_OUTPUT_PLAIN}"; \ makeinfo --plain "${PATH_MANUAL_TEXI}" > "${PATH_DOC_OUTPUT_PLAIN}"; \

41
TODO
View File

@ -2,6 +2,30 @@
# #
# This is by no means a complete list. # This is by no means a complete list.
[ target: 0.1.0 ]
Misc
- Class module is becoming too large; refactor
Member Keywords
- Restrictions; throw exceptions when unknown keywords are used
- Concrete types must implement member with same visibility, or greater
visibility, than the abstract implementation defined
Documentation
- Ensure all docblocks contain only valid JSDoc tags
- Generate documentation
- Add to Makefile
- Begin technical documentation for developers
- Include designs and project decisions
- Wiki, LaTeX, Texinfo?
- API documentation
- Wiki, LaTeX, Texinfo?
Client-Side
- implement assert.deepEqual()
[ future ]
Misc Misc
- Deep cloning level for util.clone() - Deep cloning level for util.clone()
- Optional preprocessing support - Optional preprocessing support
@ -12,16 +36,12 @@ Misc
functions, will not impact function logic. functions, will not impact function logic.
- Should be able to run source file without preprocessing, so C-style macros - Should be able to run source file without preprocessing, so C-style macros
cannot be used (# is not a valid token) cannot be used (# is not a valid token)
- Class module is becoming too large; refactor
Member Keywords Member Keywords
- Restrictions; throw exceptions when unknown keywords are used
- const; immutable properties - const; immutable properties
- final; methods cannot be overridden by subtypes - final; methods cannot be overridden by subtypes
- static; method/property accessible via class definition - static; method/property accessible via class definition
- event; designates a supported event - event; designates a supported event
- Concrete types must implement member with same visibility, or greater
visibility, than the abstract implementation defined
Typing Typing
- Support JSDoc-style type definitions for parameters - Support JSDoc-style type definitions for parameters
@ -47,16 +67,3 @@ Patterns
implement the various patterns, and serve as an excellent tool for those implement the various patterns, and serve as an excellent tool for those
unfamiliar with them. unfamiliar with them.
Documentation
- Ensure all docblocks contain only valid JSDoc tags
- Generate documentation
- Add to Makefile
- Begin technical documentation for developers
- Include designs and project decisions
- Wiki, LaTeX, Texinfo?
- API documentation
- Wiki, LaTeX, Texinfo?
Client-Side
- implement assert.deepEqual()