README.todo_rdm, 2005.01.24
===========================

This is my ToDo file, as of late January, 2005.  Because my contract is not
being renewed, I will not be able to get to them.  Sigh.

  --  Rich Morin


script-related
==============

~/fsw_cgi/fsw_docs.d/do_spider

  *  Added Bill Moseley's suggested modifications to print the names of
     PDF files that cannot be translated.  Unfortunately, pdfinfo and
     pdftotext don't return error codes on this error:

       Error (0): PDF file is damaged -
       attempting to reconstruct xref table...

     However, by adding some tracing code, I was able to determine the
     name of the document in question.  "Preview" has no problem with
     the document, so I am going to ignore the problem for now.  If I
     decide to get back to it, I can look into ways (eg, IPC::Open3)
     to trap the error message.

$FSW/web/bin/cat_*

  >  See README.lcat_*

$FSW/web/bin/latdocs_y2h
$FSW/web/bin/latdocs_y2h

  ?  Output  node (a_etc/latdocs.t.inc) missing for script 'bin/latdocs_y2h'.
  ?  Output  node (a_etc/latdocs.t.inc) missing for script 'bin/latdocs_y2h'.
  ?  Link from 'bin/latdocs_y2h' to 'a_etc/latdocs.t.inc' never shown.

  .  Currently, this script is parsing an HTML page.  It really should use
     XML, which is available (see $FSW/web/bin/Save/latdocs_y2h.xml)

$FSW/web/bin/package_y2h

  *  missing aliases:

     ? No alias for '<TBD>' in LCI, LDF, LPA, LRA, LSM, LTC.	(ignore)
     ? No alias for '?' in FMX, LCAT, LCBT, LIMP, PIG, SRT.	(ignore)
     ? No alias for 'Jean-loup Gailly' in ZLIB.			(ignore)

$FSW/web/bin/use_tree_*

  ?  What's with the question marks after 'SYS" in the table?


Development
===========

   +  Parse and indexing FSW-related LATDocs.

   +  Convert TW's APID (Excel) spreadsheet into YAML.  Generate web pages
      (eg, based on the prototype summary table) and use data for Package
      and Packet pages.

   ?  Display timelines on Package pages?

   ?  Once we have permission to post our source code, start working on
      an LXR-based browser (start with LXR?).


Kludges
=======

   +  The left-hand (linear) Y axis ticks were being offset (in the ALG
      plots) by a bug in the grap(1) implementation: It fails to handle
      unary minus signs in coord statements.

      I worked around the problem by forcing a '0' before any negative
      $y_lo_a values.  So, "-3.21" becomes "0-3.21".  This is equivalent,
      mathematically, but doesn't exercise the parsing bug.  I also sent
      bug reports to Ted Faber, on 6/1/2004.

   +  The recursion code in tidy_loaded_xml (lib/fsw_docs.pl) is _ugly_.


Missing data
============

   +  test results, from LTX

   +  C&T specifications, from LCAT

   +  Test Plan text and Requirement references, from MarkA and EricH

   +  Message log definitions (let alone data) from ITC

Miscellany
==========

   +  Diagram web  page connectivity (?)
   +  Diagram YAML file connectivity (?)

   +  Add more explanation of packages.  
   +  Format/cache oddball files for FSW_doc_df.shtml
   +  Use XML input from LATDocs (rather then HTML).