To-Do list: WOAD

1. Bug need CVS control or backup files for notes.
   It's apparently far too easy to mangle notes with a bad edit. Renaming old file to backup probably best done in <output>. (2000-12-05)
2. Bug woad-index.pl needs better duplicate-ref. check
   Currently checks only the last entry for a word; should look back over all refs with the same path in case there are different case variants. (2000-11-29)
3. Bug directory indices need time check
   must ensure dirIndex.wi at least as recent as the directory. If it's not just list it, or run the incremental indexer if it's available. (2000-10-27)
4. Hole need a way to change order of page segments
   i.e. notes, index, views, source... using the same list as used in the index bar. (2000-10-24)
5. Bug <note> must supply missing form elts on edit
   When editing or creating a <note>, supply empty form elements for the components that aren't there yet. Basically, each component needs to set a flag if it's present so that <note> can supply it if it isn't. (2000-10-24)
6. Wish stuff for maintaining to-do lists
   This could be be a separate category of note, and there ought to be specific tags for it. On the other hand, we could keep the existing HTML stuff and use a different (non-Woad) directory under Apps. (2000-10-24)
7. Bug -port doesn't work.
   you have to set rport and vport separately, apparently because woad.xcf does so. (2000-10-24)
8. Wish WOAD Proxy
   Tee every proxied page into a temporary file; you need several in order to cope with frames and broken images. If there's a corresponding WOAD source or annotation tree, offer it; otherwise it's just a good way to view source. (2000-10-19)
9. Hole Woad Warrior
   There are two potential uses for it: as a front end to a group of WOAD servers, and as a factory for WOAD server startup commands. The first might be "WOAD Farm" instead. (2000-10-19)
10. Hole notes with names: lnNNNNNN for lines
    "annotates" is, of course, easily computable. <id> needs to check for existing note, and needs a link to create one. Notes could be shown inline. Possibly too slow. (2000-10-12)
11. Bug problems with word xref indices
    Uses of filenames don't seem to be properly xref'ed. Should refrain from calling the line that defines a word a "use". Python doesn't require parens after "if", so add that to the set of words that suppress a c-like function def. (2000-10-02)
12. Bug problems with TextParser
    don't accept ":" or "." in identifiers. (2000-10-02)
    -- adding "foo:" works temporarily for Python. Doesn't fix ".".
13. Wish PIA links to public WOAD tree in dist.
    Instead of referring to a local WOAD tree, the distribution should refer to the public one on pia.rii.ricoh.com. This should be a global option in SITE:piaWoadTree, so users can change it. _subsite.xcf should check for a top-level WOAD index file. (2000-09-29)
14. Wish xref indices, parsers for man and info pages
    (2000-09-29)
15. Impr customizable views
    i.e. "processed", "wrapped", ... (2000-09-25)
16. Impr use WOAD server as proxy
    needs an agent to add a toolbar to pages from the target server.
17. Wish incremental woad-index.pl
    Could do this by building the word indices from per-directory indices in the source tree. No need to re-index a source directory if it hasn't changed. (Need a switch to override if indexing process has changed.) (2000-08-30)
18. Impr Navigation buttons in index files
    Implement as part of the wrapper element. See, e.g., the Jargon File. (2000-08-28)
19. Bug query form of word lookup breaks index links
    (but notes are OK) This probably breaks indexing in source code, too. The right way to handle word queries is redirect, but PIA can't do that yet. (2000-08-25)
20. Impr save startup parameters
    The woad command should save its command line in the root; then woad root should restart it. Implies that the filename parameter should be always (usually?) be the root. (2000-08-24)
21. Impr other word sources
    Some locations are too big to index. Jargon file is marginal. Online dictionaries like Merriam-Webster are simply out of the question, but we want to offer them in /.word. The list needs to be extensible. (2000-08-21)
22. Wish Rating, sorting, and filtering on notes
    Suggestion from Amy Bruckman. You'd like to be able to filter or sort on like author, date, author's or note's rating in any of several dimensions, etc. (2000-08-10)
23. Wish Aribtrary metadata in notes
    Suggestion from Amy Bruckman. (2000-08-10)
24. Wish Store notes using CVS
    Would provide for versioning and recovery from both unintentional damage and intentional vandalism. Could also be used for other historical metadata and for sharing annotation among widely-separated sites. Also allows for e-mail notification. Suggestion from Amy Bruckman. (2000-08-10)
25. Impr preference-based ordering for sections
    Can probably link this with the <toolbar> tag somehow; the idea is that your profile specifies the order and selection for notes, cross-references, source code, etc. (2000-08-10)
26. Bug Listings in .words don't list files!
    They should at least offer the complete listing, and by default provide a subset. (2000-08-10)
27. Bug subdirectory listings confused if prefix=""
    If the sourcePrefix is null, WOAD can't find index files in subdirectories (but does find them at the top level). Links, however, are correct. (2000-08-10)
28. Hole mappings to arbitrary other servers
    Keep lists of URLs mapped to site, source, and word trees, with optional mapping code (e.g. for forming queries). Allows totally general use of, e.g., indexers and viewers. And of course there's file:/&sourceRoot;/ for raw views. (2000-08-10)
29. Impr Full-text site indexing
    Harvest was originally associated with Glimpse, but seems still to be free. OTOH there are plenty of crawlers around, including one in SWISH-E, which is mentioned in the Harvest archives as a faster alternative to glimpse. See also harvest-ng which is in perl rather than C. (2000-08-07)
30. Impr do we need /.doc?
    Isomorphic to /.source but showing HTML documents as they are rather than marked up as source, though presumably with the Woad wrappers. Possibly called .direct instead of .doc. Source files would be shown through a documentation extractor (e.g. tsdoc). The idea being that you could view documentation embedded in the code, and view the code as documentation, and have links in the documentation work (right now they don't; you end up looking at the listing and have to click to change the format). Requires redefining <a> to fix local links. May be able to do this with just a tagset. (2000-08-04)
    -- Do not need it: just fix up links in the source listing to carry current format info.
31. Hole need CVS interface
    See cvsweb and Bonsai . (2000-07-31)
32. Bug suppress .wl extension in source listings
    .wl is used for pre-formatted or annotated listings.
33. Impr Author and user preferences
    Probably cookies are the simplest implementation. (2000-07-20)
34. Impr standard wordlists in PIA/Apps/Woad
    Possibly aliased in rather than directly in Woad/.word, but in any case we should index such standard sources as the Jargon File, Sun's Java documentation, the Apache manual, PHP, Perl, HTML, and so on. It should be easy to map lists in and out depending on the target app. Jargon index is here with sub-indices like -A- (2000-07-20)
35. Bug don't follow links to directories when indexing.
    Sometimes you need to, but in most cases this will just get you into trouble. One alternative might be to check dates on dirIndex files; another might be to keep a database of visited directories and abspaths. (2000-07-20)
36. Impr frameset with WOAD controls
    Assuming you can tell what page is being displayed, you can add controls that go to the corresponding WOAD server page. (2000-07-19)
37. Bug directories in URL-space cause havoc
    The mapping from url to various local paths is badly broken. In particular, because you can't reliably tell if the last component is a directory, you can't reliably identify the base for fixing up relative references. An "isDirectory" flag in the annotations will help. Be nice if you could get redirects from the server. Can also look in the sources -- that's totally reliable if a corresponding source directory exists. (2000-06-23)
38. Bug fix command-line decoding
    Check for presence of target, source; set vroot appropriately. It may be feasible to do it in woad.xcf. (2000-06-23)
39. Bug (site) defining namespace in config file loses
    Ends up with .source non-existant. Weird. (2000-06-23)
40. Impr Allow arbitrary links, text on index bar
    This requires using <xan> etc. tags, with some modifications. (2000-06-22)
41. Hole regenerate source dirIndex incrementally
    can perhaps be done by invoking the perl script as a CGI.
42. Impr don't index last component of path in decoratePath
    A little tricky. Either count first, or stay one step behind and add an end marker.
43. Impr (pia) optional redirect on extension path
    Optionally redirect on locating a document with an extension supplied from the path. (2000-06-22)
44. Bug (site) locate should fix pathinfo
    locate needs to chop ``.'' and ``..'' segments from the pathinfo before passing it to the listing document. (2000-06-22)
45. Impr support for woadProject under root
    (subdirectory of ~/.woad) to allow multiple WOAD servers to keep out of one anothers' way. -- it would also provide an alternative to [TOP]. (2000-06-21)
46. Wish support for multiple source directories
    woad-index.pl needs to take multiple source files. (2000-06-21)
47. Bug prefixes not robust
    Need to explicitly force prefixes to have or not have leading slash. (2000-06-16)
    
48. Bug (site) file: in .xcf file
    Need to be able to make virtual links to absolute paths, and it works, but there ought to be some kind of restriction to prevent security holes. Possibly restrict to normal user, not pia; also perhaps make the resulting subtrees non-trusted. (2000-05-30)
49. Bug (site) override config file name
    Need to be able to override _subsite.xcf as the default configuration file name in subsites. Currently, configFileName is only in Site. (2000-05-30)
50. Bug (site) re-read config file
    Need to be able to re-read the subsite config file in order to make changes to projects. (2000-05-30)
51. Bug (pia) make PIA namespace available to config files
    Configuration files need to be read with the PIA: namespace in effect. It's actually more subtle: a Site under construction has to read its own site-config file (oops). It's not an issue if it's just using the default _subsite.xcf. (2000-05-30)
52. Hole make Woad: namespace available in subs.
    It turns out that what you need is &Woad:path; for the path to wherever Woad's home directory is. It gets used for forms, for example.