Blame TODO

Packit 7a7948
		PACKAGING
Packit 7a7948
Packit 7a7948
- Directories should be owned
Packit 7a7948
Packit 7a7948
- Use macros to ease porting
Packit 7a7948
Packit 7a7948
- install-catalog has problems with updates because the post-install
Packit 7a7948
  is called before the post-uninstall
Packit 7a7948
Packit 7a7948
Packit 7a7948
		PRINTING
Packit 7a7948
Packit 7a7948
- Support hyperlinks in acroread
Packit 7a7948
Packit 7a7948
Hyperlinks are rendered nicely when converted to PDF, but aren't
Packit 7a7948
dynamical in acroread (they are just underlined text)
Packit 7a7948
Packit 7a7948
- Support Asian languages on printing
Packit 7a7948
Packit 7a7948
Already did some tries with hlatex (Korean)
Packit 7a7948
Packit 7a7948
- Italian does not seem to work when printing
Packit 7a7948
Packit 7a7948
Solved with the new packaging of jadetex?
Packit 7a7948
Packit 7a7948
- Tables aren't rendered nicely when printing
Packit 7a7948
Packit 7a7948
The second line of text and the following ones have no margin
Packit 7a7948
Packit 7a7948
- Add a switch to control TeX verbosity
Packit 7a7948
Packit 7a7948
Packit 7a7948
		BACKENDS
Packit 7a7948
Packit 7a7948
- Do a new text backend based on html2text instead of lynx
Packit 7a7948
Packit 7a7948
Merge Jochem's stuff with the current text backend. The choice of
Packit 7a7948
the method should be passed through the command line or through an
Packit 7a7948
configuration file.
Packit 7a7948
Packit 7a7948
- Do a FOT backend, MIF backend and a palm backend
Packit 7a7948
Packit 7a7948
Should be easy. Use -V and -t variables.
Packit 7a7948
Packit 7a7948
- Backend options
Packit 7a7948
Packit 7a7948
Provide an -e option in jw to pass directly a string to the backend
Packit 7a7948
through the SGML_EXTRA_OPTS variable. The html backend then can pass
Packit 7a7948
it to Jade through the -V option.
Packit 7a7948
Packit 7a7948
- Configuration file for backends
Packit 7a7948
Packit 7a7948
Pass a variable holding the name of the initialization file to the
Packit 7a7948
backend.
Packit 7a7948
Packit 7a7948
(is this really needed?)
Packit 7a7948
Packit 7a7948
Packit 7a7948
		JW
Packit 7a7948
Packit 7a7948
- Configuration variables for jw
Packit 7a7948
Packit 7a7948
Simpler and more powerful to use "aliases" ?
Packit 7a7948
Packit 7a7948
Name:           SGML_BACKEND_DIR
Packit 7a7948
    Content:    Directory containing the backends.
Packit 7a7948
    Default:    $SGML_BASE_DIR/backends/
Packit 7a7948
    Example:	/usr/share/sgml/docbook/docbook-utils-0.2/backends/
Packit 7a7948
    Notes:      This directory should contain nothing else than backends. 
Packit 7a7948
                This way a program can tell the user about available
Packit 7a7948
                backends by just doing "ls $SGML_BACKEND_DIR" or similar.
Packit 7a7948
Packit 7a7948
Name:           SGML_BACKEND
Packit 7a7948
    Content:    The name of the default backend
Packit 7a7948
    Default:    html
Packit 7a7948
(txt would be more neutral, but then be painful to the docbook users)
Packit 7a7948
    Example:	ps
Packit 7a7948
Packit 7a7948
Name:           SGML_FRONTEND_DIR
Packit 7a7948
    Content:    Directory containing the frontends.
Packit 7a7948
    Default:    $SGML_BASE_DIR/frontends/
Packit 7a7948
    Example:	/usr/share/sgml/docbook/docbook-utils-0.2/frontends/
Packit 7a7948
    Notes:      This directory should contain nothing else than frontends. 
Packit 7a7948
                This way a program can tell the user about available
Packit 7a7948
                frontends by just doing "ls $SGML_FRONTEND_DIR" or similar.
Packit 7a7948
Packit 7a7948
Name:           SGML_FRONTEND
Packit 7a7948
    Content:    The name of the default frontend
Packit 7a7948
    Default:    docbook
Packit 7a7948
(sgml would be more neutral, but then be painful to the docbook users)
Packit 7a7948
    Example:	tei
Packit 7a7948
    Notes:	At the time of determining the frontend, the frontend is not
Packit 7a7948
		known, so it is /etc/sgml/sgml.conf or $HOME/.sgml.conf
Packit 7a7948
		that is used as a configuration file.
Packit 7a7948
Packit 7a7948
Name:           SGML_HELPERS_DIR
Packit 7a7948
    Content:    The name of the directory where reside the scripts that
Packit 7a7948
		can be called by the backends and the frontends
Packit 7a7948
    Default:    $SGML_BASE_DIR/helpers/
Packit 7a7948
    Example:	/usr/share/sgml/docbook/docbook-utils-0.2/helpers/
Packit 7a7948
Packit 7a7948
Name:           SGML_OUTPUT_DIR
Packit 7a7948
    Content:    The directory to write the converted output files to.
Packit 7a7948
    Default:    .
Packit 7a7948
    Example:	/tmp
Packit 7a7948
    Note:	This is not backend-specific. If for example the html
Packit 7a7948
		backend wants to put the resulting files in an directory named
Packit 7a7948
		HTML, it can override or refine this setting.
Packit 7a7948
Packit 7a7948
Name:           SGML_FILE
Packit 7a7948
    Content:    The filename of the SGML source-file to convert.
Packit 7a7948
    Default:    index.sgml
Packit 7a7948
    Example:	index.docbook
Packit 7a7948
Packit 7a7948
Name:		SGML_JADE
Packit 7a7948
    Content:	The flavour of jade parser to execute
Packit 7a7948
    Default:	jade
Packit 7a7948
    Example:    openjade
Packit 7a7948
    Notes:	This variable is unused if using another parser
Packit 7a7948
Packit 7a7948
Name:           SGML_STYLESHEET
Packit 7a7948
    Content:    The stylesheet to use
Packit 7a7948
    Default:    (unset)
Packit 7a7948
    Example:	/usr/share/sgml/docbook/kde-0.1/stylesheet/kde.dsl#html
Packit 7a7948
Packit 7a7948
An "alias" on the contrary would concentrate all the options passed on the command
Packit 7a7948
line into a single symbol. Example:
Packit 7a7948
      htmlkde <=> -c /usr/share/sgml/docbook/kde-0.1/catalog
Packit 7a7948
                  -d /usr/share/sgml/docbook/kde-0.1/kde.dsl#html