inweb-bootstrap/Figures/help.txt
2020-03-27 23:15:40 +00:00

48 lines
2.5 KiB
Text

inweb: a tool for literate programming
Usage: inweb WEB OPTIONS RANGE
WEB must be a directory holding a literate program (a 'web')
The legal RANGEs are:
all: complete web (the default if no TARGETS set)
P: all preliminaries
1: Chapter 1 (and so on)
A: Appendix A (and so on, up to Appendix O)
3/eg: section with abbreviated name "3/eg" (and so on)
You can also, or instead, specify:
index: to weave an HTML page indexing the project
chapters: to weave all chapters as individual documents
sections: ditto with sections
-advance-build increment daily build code for the web
-advance-build-file X increment daily build code in file X
-breadcrumb X use the text X as a breadcrumb in overhead navigation
-catalog same as '-catalogue'
-catalogue list the sections in the web
-functions catalogue the functions in the web
-gitignore X write a .gitignore file for this web and store it in X
-import-from X specify that imported modules are at pathname X
-makefile X write a makefile for this web and store it in X
-navigation X use the file X as a column of navigation links
-open weave then open woven file
-prototype X translate makefile from prototype X
-scan scan the web
-structures catalogue the structures in the web
-tangle tangle the web into machine-compilable form
-tangle-to X tangle, but to filename X
-verbose explain what inweb is doing (default is -no-verbose)
-weave weave the web into human-readable form
-weave-as X set weave pattern to X (default is 'HTML')
-weave-docs weave the web for use at GutHub Pages
-weave-into X weave, but into directory X
-weave-tag X weave, but only using material tagged as X
-weave-to X weave, but to filename X (for single files only)
-write-me X write a read-me file following instructions in file X
-at X specify that this tool is installed at X
-crash intentionally crash on internal errors, for backtracing (default is -no-crash)
-fixtime pretend the time is 11 a.m. on 28 March 2016 for testing (default is -no-fixtime)
-help print this help information
-log X write the debugging log to include diagnostics on X
-version print out version number