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
TESTS_JS := $(shell find "./test" -name 'test-*.js')
TESTS_SHELL := $(shell find "./test" -name 'test-[^\.]*')
.PHONY: test doc
@ -26,23 +29,21 @@ all: combine doc
# create build dir
mkbuild:
@mkdir -p "${PATH_BUILD}"
mkdir -p "${PATH_BUILD}"
# combine all modules into easily redistributable ease.js file (intended for
# browser)
combine: mkbuild
${COMBINE} > "${PATH_COMBINE_OUTPUT}"
INC_TEST=1 "${COMBINE}" > "${PATH_COMBINE_OUTPUT_FULL}"
@cp "${PATH_BROWSER_TEST}" "${PATH_BUILD}"
cp "${PATH_BROWSER_TEST}" "${PATH_BUILD}"
# run tests
test: default
for test in `find ./test -name 'test-*.js'`; do \
node $${test}; \
done; \
for test in `find ./test -regex '.*/test-[^\.]*'`; do \
./$$test; \
done;
test: default $(TESTS_JS) $(TESTS_SHELL)
test-%.js: default
node $@
test-%: default
./$@
# generate texinfo documentation (twice to generate TOC), then remove the extra
# files that were generated
@ -57,7 +58,7 @@ doc: mkbuild
! -name '*.pdf' -a \
! -name '*.css' \
| xargs rm
@mv -f "${PATH_DOC}"/*.pdf "${PATH_DOC_OUTPUT}"
mv -f "${PATH_DOC}"/*.pdf "${PATH_DOC_OUTPUT}"
cd "${PATH_DOC}"; \
makeinfo -o "${PATH_DOC_OUTPUT_INFO}" "${PATH_MANUAL_TEXI}"; \
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.
[ 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
- Deep cloning level for util.clone()
- Optional preprocessing support
@ -12,16 +36,12 @@ Misc
functions, will not impact function logic.
- Should be able to run source file without preprocessing, so C-style macros
cannot be used (# is not a valid token)
- Class module is becoming too large; refactor
Member Keywords
- Restrictions; throw exceptions when unknown keywords are used
- const; immutable properties
- final; methods cannot be overridden by subtypes
- static; method/property accessible via class definition
- event; designates a supported event
- Concrete types must implement member with same visibility, or greater
visibility, than the abstract implementation defined
Typing
- Support JSDoc-style type definitions for parameters
@ -47,16 +67,3 @@ Patterns
implement the various patterns, and serve as an excellent tool for those
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()