On Wed, Nov 24, 2004 at 02:40:39PM +0100, Vincent Lefevre wrote: > On 2003-04-14 15:24:26 +0200, Vincent Lefevre wrote: > > When I try to generate the manual.txt file for Mutt (CVS version) with > > > > sgml2txt -c latin manual > > > > (from the mutt/doc directory). I get the following output: > > > > Processing file manual > > troff: fatal error: can't find macro file s > > The problem came from the fact that the groff package wasn't > installed. The groff package is in the "Suggests:" field, but > shouldn't it be in "Depends:"? >
Hi, Vincent, Looking at more old linuxdoc-tools bugreports, Out-of-the-box linuxdoc-tools will only process sgml to html. For info, tex and txt targets other packages are required. linuxdoc-tools-text, linuxdoc-tools-latex and linuxdoc-tools-info will pull those dependencies for you. I think the reason why the maintainer (Taketoshi Sano) used 'suggests' instead of 'recommends' or 'depends' is that he found html conversion useful enough to make 'suggests' apropriate. That is explained in the package description (with some obsolete packages). That description seems to me too verbose and containing things that should go better in a README.Debian file. Submitter for another bug report proposed to make it shorter, and I agree here. A lot of stuff there should go, IMHO to README.Debian. Since maintainer seems to be very busy, I have written a possible README.Debian with some things I find better there than in package description, find it attached. Package description could then be something like --------------------------------------------------------- Description: SGML converters for the LinuxDoc DTD only. LinuxDoc is a kind of SGML DTD. It was created for the Linux HOWTOs, and is being used by the Linux Documentation Project (LDP). linuxdoc-tools was created on the basis of sgml-tools_v1, and has been designed and implemented only for linuxdoc DTD. . HTML can be generated without any other Debian text processing package, but for the other formats the appropriate packages will have to be installed. See /usr/share/doc/README.Debian. --------------------------------------------------------- -- Agustin
linuxdoc-tools README for Debian ================================ Dependencies ------------ out-of-the-box linuxdoc-tools will only provide support for sgml2html conversion. Other conversions will need other Debian packages be installed. Those dependencies will be pulled either by linuxdoc-tools-text, linuxdoc-tools-info or linuxdoc-tools-latex packages, although you can install them by your own. The relevant dependencies are: sgml2txt: * groff package sgml2info: * texinfo package sgml2latex: * texlive-latex-base | tetex-base * texlive-base-bin | tetex-bin * texlive-latex-recommended | tetex-extra Different backends ------------------ The main command is linuxdoc, and -B option is provided to choose the proper backend driver for desired output: linuxdoc -B check: for syntax checking linuxdoc -B html: conversion to html linuxdoc -B info: conversion to info linuxdoc -B latex: conversion to latex, dvi, and postscript linuxdoc -B lyx: conversion to lyx linuxdoc -B rtf: conversion to rtf linuxdoc -B txt: conversion to text Handling of other DTD --------------------- linuxdoc-tools has been designed and implemented only for linuxdoc DTD. If you wish to convert debiandoc DTD documents, please install and use debiandoc-sgml package. If you wish to convert docbook DTD documents, please install and use jade (with or without sgmltools-lite). -- Agustin Martin Domingo <[EMAIL PROTECTED]>, Fri, 25 May 2007 15:31:20 +0200
