Re: [Fwd: [Bug 688] - make documentation produces only files as 'x6772.html']

[Tony Lambregts]

Tony Lambregts wrote:
> Vincent Béron wrote:
> > Hi guys,
> >
> > Alexandre just committed my patch concerning the documentation building
> > process. Could you verify it works for you?
>
> I am sure it is something on my end but I get the following when I 
> "make html",  "make everything"
>
> docbook2html -d ./default.dsl -o wine-devel wine-devel.sgml
> Using catalogs: /etc/sgml/sgml-docbook-3.1.cat
> Using stylesheet: ./default.dsl
> Working on: /usr/local/src/wine/documentation/wine-devel.sgml
> jade:E: cannot find "./default.dsl"; tried "./default.dsl", 
> "/usr/share/sgml/./default.dsl"
> jade:E: specification document does not have the DSSSL architecture as 
> a base architecture
> .....
> spews out sgml
> ....
>
> It must be something I've done but I have no idea what, since
> db2html -d ./faq-plain.dsl wine-faq.sgml
> jade:E: cannot find "./faq-plain.dsl"; tried "./faq-plain.dsl", 
> "/usr/share/sgml/./faq-plain.dsl"
> jade:E: specification document does not have the DSSSL architecture as 
> a base architecture
>
> same thing. WTF.

Ok  heres what I have found. "db2html -d ../faq-plain.dsl wine-faq.sgml 
" works, However if I use "db2html -d ./faq-plain.dsl wine-faq.sgml " it 
blows chunks. as I reported.

So the change to two dots works, which makes sense, therfore I changed 
the Makefile so that  SRCDIR = .. and re-ran "make html" and produces 
the html beautifully.

So all that tells me is "There is something wrong here" ./ should work 
(right?)

-- 

Tony Lambregts

[Fwd: [Bug 688] - make documentation produces only files as 'x6772.html']

[Vincent Béron]

Le sam 23/11/2002 à 11:55, Tony Lambregts a écrit :
> Ok  heres what I have found. "db2html -d ../faq-plain.dsl wine-faq.sgml 
> " works, However if I use "db2html -d ./faq-plain.dsl wine-faq.sgml " it 
> blows chunks. as I reported.
>
> So the change to two dots works, which makes sense, therfore I changed 
> the Makefile so that  SRCDIR = .. and re-ran "make html" and produces 
> the html beautifully.
>
> So all that tells me is "There is something wrong here" ./ should work 
> (right?)

Could you send me both your docbook2html and db2html please, along with
/usr/bin/jw, and tell me what distro/package they come from? Thank you.

Seems all those scripts don't handle the location of stylesheets the
same way...

Vincent

[Fwd: [Bug 688] - make documentation produces only files as 'x6772.html']

[Tony Lambregts]

Vincent Béron wrote:
> Could you send me both your docbook2html and db2html please, along with
> /usr/bin/jw, and tell me what distro/package they come from? Thank you.
>
> Seems all those scripts don't handle the location of stylesheets the
> same way...

The packages are for RedHat 7.2 from Ximian (Gnome)

-- 

Tony Lambregts



#! /bin/sh

ADMON_GRAPHICS=/usr/share/sgml/docbook/dsssl-stylesheets/images/*.gif

output=docbook2html-dir
skip=0
for arg in "$@"
do
  if [ $skip -gt 0 ]
  then
    skip=$(($skip - 1))
    continue
  fi
  case $arg in
  -h|--help|-v|--version)	break
				;;
  -n|--nostd|-u|--nochunks)	;;
  -*)				skip=1
				;;
  *)	output="$(echo $arg | sed 's,\.sgml$,,;s,\.sgm$,,')"
	echo "output is $output"
	break
	;;
  esac
done
if [ -d ${output} ]
then
  rm -rf ${output}.junk
  mv ${output} ${output}.junk
fi
mkdir ${output}
mkdir ${output}/stylesheet-images
cp ${ADMON_GRAPHICS} ${output}/stylesheet-images
jw -f docbook -b html -o ${output} "$@"

#! /bin/sh
jw -f docbook -b html "$@"

#! /bin/sh
# Jade Wrapper
# Script to convert a SGML file into some other format
# Send any comments to Eric Bischoff <eric(a)caldera.de>
# This program is under GPL license. See LICENSE file for details.

# Set help message
SGML_HELP_MESSAGE="Usage: `basename $0` [<options>] <sgml_file>\n\
where <options> are:\n\
\040 -f|--frontend <frontend>: \t Specify the frontend (source format)\n\
\040 \t\t\t\t (default is docbook)\n\
\040 -b|--backend <backend>: \t Specify the backend (destination format)\n\
\040 \t\t\t\t (default is html)\n\
\040 -c|--cat <file>: \t\t Specify an extra SGML open catalog\n\
\040 -n|--nostd: \t\t\t Do not use the standard SGML open catalogs\n\
\040 -d|--dsl <file>|default|none:\t Specify an alternate style sheet\n\
\040 \t\t\t\t (default is to use the default stylesheet)\n\
\040 -l|--dcl <file>: \t\t Specify an alternate SGML declaration\n\
\040 \t\t\t\t (usual ones like xml.dcl get detected automatically)\n\
\040 -s|--sgmlbase <path>: \t Change base directory for SGML distribution\n\
\040 \t\t\t\t (usually /usr/share/sgml)\n\
\040 -p|--parser <program>: \t Specify the parser if several are installed\n\
\040 \t\t\t\t  (jade or openjade)\n\
\040 -o|--output <directory>: \t Set output directory\n\
\040 -u|--nochunks: \t\t Output only one big file\n\
\040 \t\t\t\t (overrides the stylesheet settings)\n\
\040 -i|--include <section>: \t Specify a SGML marked section to include\n\
\040 \t\t\t\t (should be marked as \"ignore\" in the SGML text)\n\
\040 -w|--warning <warning_type>|list: Control warnings or display the allowed warning types\n\
\040 -e|--errors <error_type>|list: Control errors or display the allowed error types\n\
\040 -h|--help: \t\t\t Print this help message and exit\n\
\040 -v|--version: \t\t Print the version and exit"

# Set list of warning types
SGML_WARNINGS_LIST="\n\
\040 xml \t\t Warn about constructs that are not allowed by XML\n\
\040 mixed \t Warn about mixed content models that do not allow #pcdata anywhere\n\
\040 sgmldecl \t Warn about various dubious constructions in the SGML declaration\n\
\040 should \t Warn about various recommendations made in ISO 8879 that the document does not comply with\n\
\040 default \t Warn about defaulted references\n\
\040 duplicate \t Warn about duplicate entity declarations\n\
\040 undefined \t Warn about undefined elements: elements used in the DTD but not defined\n\
\040 unclosed \t Warn about unclosed start and end-tags\n\
\040 empty \t Warn about empty start and end-tags\n\
\040 net \t\t Warn about net-enabling start-tags and null end-tags\n\
\040 min-tag \t Warn about minimized start and end-tags. Equivalent to: unclosed, empty and net\n\
\040 unused-map \t Warn about unused short reference maps\n\
\040 unused-param \t Warn about parameter entities that are defined but not used in a DTD\n\
\040 notation-sysid Warn about notations for which no system identifier could be generated\n\
\040 all \t\t Equivalent to: mixed, should, default, undefined, sgmldecl, unused-map, unused-param, empty and unclosed\n\n\
\040 A warning can be disabled by using its name prefixed with no-. Example: -w all -w no-duplicate"

# Set list of error types
SGML_ERRORS_LIST="\n\
\040 no-idref \t No error for an ID reference value which no element has as its ID\n\
\040 no-significant No errors for characters not significant in the reference concrete syntax\n\
\040 no-valid \t Do not require the document to be type-valid"

# Get name of main SGML configuration file
which sgmlwhich >/dev/null 2>/dev/null
if [ $? -eq 0 ]
then
  SGML_CONF=`sgmlwhich`
else
  SGML_CONF="/etc/sgml/sgml.conf"
fi

# Set version message
SGML_VERSION_MESSAGE="DocBook-utils version 0.6.9 (jw version 1.1)"

# Set frontend to use
SGML_FRONTEND="docbook"

# Set backend to use
SGML_BACKEND="html"

# Set option: use standard catalogs
SGML_STANDARD_CATALOGS="yes"

# Set path to user SGML catalogs
SGML_EXTRA_CATALOGS=""

# Set SGML base directory and centralized catalogs directory
SGML_BASE_DIR="/usr/share/sgml"
SGML_CATALOGS_DIR="/etc/sgml"
if [ -f "$SGML_CONF" ]
then
  RE='^[:space:]*SGML_BASE_DIR[:space:]*=[:space:]*'
  SGML_BASE_DIR=`grep $RE $SGML_CONF | sed "s/$RE//"`
  RE='^[:space:]*SGML_CATALOGS_DIR[:space:]*=[:space:]*'
  SGML_CATALOGS_DIR=`grep $RE $SGML_CONF | sed "s/$RE//"`
fi

# Set main stylesheet
SGML_STYLESHEET="default"

# Set flavour of jade parser to use
SGML_JADE=""

# Set SGML declaration and file to process
SGML_DECL=""
SGML_FILE=""

# Set output and current directories
SGML_OUTPUT_DIRECTORY="."
SGML_CURRENT_DIRECTORY=`pwd`

# Set option: do not output many chunks
SGML_NOCHUNKS=""

# Set list of "include" marked sections
SGML_INCLUDE=""

# Set list of warning types and errors types
SGML_WARNINGS=""

# Process options
while [ $# -gt 0 ]
do case $1 in
  -f|--frontend) SGML_FRONTEND=$2
		shift 2
		;;
  -b|--backend)	SGML_BACKEND=$2
		shift 2
		;;
  -c|--cat)	SGML_EXTRA_CATALOGS=$SGML_EXTRA_CATALOGS:$2
		shift 2
		;;
  -d|--dsl)	SGML_STYLESHEET=$2
		shift 2
		;;
  -l|--dcl)	SGML_DECL=$2
		shift 2
		;;
  -n|--nostd)	SGML_STANDARD_CATALOGS="no"
		shift 1
		;;
  -s|--sgmlbase) SGML_BASE_DIR=$2
		shift 2
		;;
  -p|--parser)	SGML_JADE=$2
		shift 2
		;;
  -o|--output)	SGML_OUTPUT_DIRECTORY=$2
		shift 2
		;;
  -u|--nochunks) SGML_NOCHUNKS="-V nochunks"
		shift 1
		;;
  -i|--include)	case $2 in
		  print|html)	echo "The marked section named \"$2\" is reserved for internal use by `basename $0`." >&2
				exit 1
				;;
		esac
		SGML_INCLUDE="$SGML_INCLUDE -i $2"
		shift 2
		;;
  -w|--warning)	case $2 in
		  list) echo -e "List of allowed warning types (multiple -w options are allowed):\n"
			echo -e $SGML_WARNINGS_LIST
			exit 0
			;;
		  xml|mixed|sgmldecl|should|default|duplicate|undefined|unclosed|empty|net|min-tag|unused-map|unused-param|notation-sysid|all|no-xml|no-mixed|no-sgmldecl|no-should|no-default|no-duplicate|no-undefined|no-unclosed|no-empty|no-net|no-min-tag|no-unused-map|no-unused-param|no-notation-sysid) \
			SGML_WARNINGS="$SGML_WARNINGS -w $2"
			shift 2
			;;
		  *)	echo "Unknown warning type \"$2\". Allowed warning types are:" >&2
		        echo -e $SGML_WARNINGS_LIST >&2
			exit 1
			;;
		esac
		;;
  -e|--error)	case $2 in
		  list) echo -e "List of allowed error types (multiple -e options are allowed):\n"
			echo -e $SGML_ERRORS_LIST
			exit 0
			;;
		  no-idref|no-significant|no-valid) \
			SGML_WARNINGS="$SGML_WARNINGS -w $2"
			shift 2
			;;
		  *)	echo "Unknown error type \"$2\". Allowed error types are:" >&2
		        echo -e $SGML_ERRORS_LIST >&2
			exit 1
			;;
		esac
		;;
  -h|--help)	echo -e "`basename $0` - Jade Wrapper\n"
		echo -e $SGML_HELP_MESSAGE
		exit 0
		;;
  -v|--version)	echo -e $SGML_VERSION_MESSAGE
		exit 0
		;;
  -*)		echo -e $SGML_HELP_MESSAGE >&2
		exit 1
		;;
  *)		if [ -z "$SGML_FILE" ]
		then
		  SGML_FILE=$1
		  shift 1
		else
		  echo -e $SGML_HELP_MESSAGE >&2
		  exit 1
		fi
		;;
  esac
done

# Check that we have a frontend
if [ -z "$SGML_FRONTEND" ]
then
  echo -e $SGML_HELP_MESSAGE >&2
  exit 1
fi
if [ -n "${SGML_FRONTEND%%/*}" ]
then
  SGML_FRONTEND=$SGML_BASE_DIR/docbook/utils-0.6.9/frontends/$SGML_FRONTEND
fi
if [ ! -s $SGML_FRONTEND ]
then
  echo "`basename $0`: There is no frontend called \"$SGML_FRONTEND\"." >&2
  exit 2
fi

# Check that we have a backend
if [ -z "$SGML_BACKEND" ]
then
  echo -e $SGML_HELP_MESSAGE >&2
  exit 1
fi
if [ -n "${SGML_BACKEND%%/*}" ]
then
  SGML_BACKEND=$SGML_BASE_DIR/docbook/utils-0.6.9/backends/$SGML_BACKEND
fi
if [ ! -s $SGML_BACKEND ]
then
  echo "`basename $0`: There is no backend called \"$SGML_BACKEND\"." >&2
  exit 2
fi

# Check that we have a file to process
if [ -z "$SGML_FILE" ]
then
  echo -e $SGML_HELP_MESSAGE >&2
  exit 1
fi
case $SGML_FILE in
   /*)	;;
   *)	SGML_FILE=`pwd`/$SGML_FILE
	;;
esac
if [ ! -s $SGML_FILE ]
then
  echo "`basename $0`: Cannot open \"$SGML_FILE\"." >&2
  exit 3
fi

# Separate the file name and the extension (if any)
SGML_FILE_NAME=`basename $SGML_FILE`
SGML_FILE_NAME=${SGML_FILE_NAME%.*}

# Determine if we are in an XML file
SGML_XML=`(grep "<?xml.*?>" $SGML_FILE; echo "sgml") | head -n 1 | sed 's/^.*xml.*$/xml/'`

# Use SGML declaration for XML if needed
if [ "$SGML_DECL" = "" -a "$SGML_XML" = "xml" ]
then SGML_DECL=${SGML_BASE_DIR}/xml.dcl
fi

# Set path to SGML catalogs (first try centralized catalog)
case $SGML_STANDARD_CATALOGS in
  yes)	export SGML_CATALOGS_DIR SGML_FILE SGML_XML
	SGML_CENTRALIZED_CATALOG=`sh $SGML_FRONTEND centralized-catalog`
	if [ -s $SGML_CENTRALIZED_CATALOG ]
	then
	  SGML_CATALOG_FILES=$SGML_CENTRALIZED_CATALOG
	else
	  SGML_CATALOG_FILES=`find $SGML_BASE_DIR -name catalog`
	  SGML_CATALOG_FILES=`echo "$SGML_CATALOG_FILES" | tr [:space:] :`
	fi
	;;
  no)	SGML_CATALOG_FILES=""
	;;
esac
SGML_CATALOG_FILES=${SGML_CATALOG_FILES}${SGML_EXTRA_CATALOGS}
SGML_CATALOG_FILES=`echo "$SGML_CATALOG_FILES" | sed 's/^://;s/:$//'`
if [ -z "$SGML_CATALOG_FILES" ]
then
  echo "`basename $0`: Please specify at least one catalog" >&2
  exit 4
fi

# Determine the backend type
case $SGML_BACKEND in
  *html) \
	SGML_TYPE=html
	;;
  *)	SGML_TYPE=print
	;;
esac

# Determine which stylesheet to use
# (run the frontend to know it if the default stylesheet or no custom stylesheet is desired)
if [ "$SGML_STYLESHEET" = "default" -o "$SGML_STYLESHEET" = "none" ]
then
  export SGML_BASE_DIR SGML_TYPE SGML_STYLESHEET
  SGML_STYLESHEET=`sh $SGML_FRONTEND style-sheet`
  SGML_RETURN=$?
  if [ $SGML_RETURN -gt 0 ]
  then exit `expr 7 + $SGML_RETURN`
  fi
fi
if [ -z "$SGML_STYLESHEET" ]
then
  echo "`basename $0`: Please specify at least one stylesheet" >&2
  exit 5
fi

# Choose a parser
if [ -z "$SGML_JADE" ]
then
  which jade >/dev/null 2>/dev/null
  if [ $? -eq 0 ]
  then
    SGML_JADE="jade"
  else
    which openjade >/dev/null 2>/dev/null
    if [ $? -eq 0 ]
    then 
      SGML_JADE="openjade"
    else
      echo "`basename $0`: No parser available" >&2
      exit 6
    fi
  fi
else
  which $SGML_JADE >/dev/null 2>/dev/null
  if [ $? -ne 0 ]
  then 
    echo "`basename $0`: parser $SGML_JADE is not available" >&2
    exit 6
  fi
fi

# Create output directory if not available
if [ -z "$SGML_OUTPUT_DIRECTORY" ]
then
  echo -e $SGML_HELP_MESSAGE >&2
  exit 1
fi
if [ ! -d $SGML_OUTPUT_DIRECTORY ]
then
  mkdir $SGML_OUTPUT_DIRECTORY 2>/dev/null
  if [ $? -ne 0 ]
  then
    echo "`basename $0`: Could not create \"$SGML_OUTPUT_DIRECTORY\" output directory" >&2
    exit 7
  fi
fi

# Prepare the parser's arguments
SGML_ARGUMENTS="$SGML_INCLUDE -i $SGML_TYPE -d $SGML_STYLESHEET $SGML_NOCHUNKS $SGML_WARNINGS $SGML_DECL $SGML_FILE"

# Call the backend
echo "Using catalogs: `echo $SGML_CATALOG_FILES | sed 's/:/, /g'`"
echo "Using stylesheet: $SGML_STYLESHEET"
echo "Working on: $SGML_FILE"
cd $SGML_OUTPUT_DIRECTORY
export SGML_JADE SGML_FILE_NAME SGML_ARGUMENTS
export SGML_CATALOG_FILES SGML_BASE_DIR SGML_FILE SGML_STYLESHEET
if [ -z "$SGML_NOCHUNKS" ]
then
	sh $SGML_BACKEND
else
	sh $SGML_BACKEND >$SGML_FILE_NAME.html
fi
SGML_RETURN=$?
cd $SGML_CURRENT_DIRECTORY

if [ $SGML_RETURN -gt 0 ]
then exit `expr 7 + $SGML_RETURN`
fi
echo "Done."
exit 0

[Fwd: [Bug 688] - make documentation produces only files as 'x6772.html']

[Vincent Béron]

Le sam 23/11/2002 à 16:19, Tony Lambregts a écrit :
/usr/bin/jw:
> \040 -d|--dsl <file>|default|none:\t Specify an alternate style sheet\n\
> \040 -s|--sgmlbase <path>: \t Change base directory for SGML distribution\n\

Here's the use of -d and -s for Tony's jw. They are the same as mine.
Joerg's are different (-d for DVI output, -s for the style sheet).
So we cannot use db2html (or docbook2html), because each of them call
jw.
We'll have to call jade directly (probably similar to what's in
db2html-winehq, if not that file).
> -d|--dsl)	SGML_STYLESHEET=$2
>       shift 2
>       ;;
> -d|--dsl)    case "$2" in
>                 /*|none|default) SGML_STYLESHEET="$2" ;;
>                  *) SGML_STYLESHEET="$SGML_CURRENT_DIRECTORY/$2" ;;
>               esac

Top is Tony's (docbook-utils-0.6.9), bottom is mine
(docbook-utils-0.6.11). You see that the first one directly uses
whatever stylesheet we gave it, while the second makes sure there's a
path component. In conjunction with the cd's below, it explains why it
doesn't work for Tony while it works for me. This is easy to fix: just
feed it an absolute path rather than a relative.
> cd $SGML_OUTPUT_DIRECTORY
> ...
> cd $SGML_CURRENT_DIRECTORY

Pair of cd's, explaining the need for an absolute path for the style
sheet.

I just need to find a way to work with Suse (as I haven't heard anything
else for other distributions).

Vincent

[Fwd: [Bug 688] - make documentation produces only files as 'x6772.html']

[Joerg Mayer]

On Sat, Nov 23, 2002 at 09:55:32AM -0700, Tony Lambregts wrote:
> Ok  heres what I have found. "db2html -d ../faq-plain.dsl wine-faq.sgml 
> " works, However if I use "db2html -d ./faq-plain.dsl wine-faq.sgml " it 
> blows chunks. as I reported.
>
> So the change to two dots works, which makes sense, therfore I changed 
> the Makefile so that  SRCDIR = .. and re-ran "make html" and produces 
> the html beautifully.

Fails for me too:

jmayer(a)alice:~/work/wine/wine/documentation> make everything
db2html -d ./default.dsl -o wine-devel wine-devel.sgml
Filename suffix "dsl" ambiguous: ./default.dsl
make: *** [wine-devel/index.html] Fehler 1

----------------------------------------------

jmayer(a)alice:~/work/wine/wine/documentation> db2html --version
db2html - docbook-toys 0.61.0

----------------------------------------------

jmayer(a)alice:~/work/wine/wine/documentation> rpm -qilf /usr/bin/db2html
Name        : docbook-toys                 Relocations: (not relocateable)
Version     : 0.61.0                            Vendor: SuSE Linux AG, Nuernberg, Germany
Release     : 173                           Build Date: Mon 09 Sep 2002 22:13:46 CEST
Install date: Sam 05 Okt 2002 15:48:07 CEST      Build Host: amdsim5.suse.de
Group       : Productivity/Publishing/DocBook   Source RPM: docbook-toys-0.61.0-173.src.rpm
Size        : 97902                            License: GPL
Packager    : http://www.suse.de/feedback
URL         : http://www.suse.de/~ke/docbook-toys/
Summary     : DocBook Tools
Description :
A shell script to convert SGML documents which are based on the DocBook DTD.

For usage information read:

    /usr/share/doc/packages/docbook-toys/README

Authors:
--------
    Karl Eichwalder  <ke(a)suse.de>
    Mark Galassi  <rosalia(a)cygnus.com>
Distribution: SuSE Linux 8.1 (i386)
/usr/bin/db2dvi
/usr/bin/db2fot
/usr/bin/db2html
/usr/bin/db2mif
/usr/bin/db2pdf
/usr/bin/db2ps
/usr/bin/db2rtf
/usr/bin/db2tex
/usr/bin/db2x.sh
/usr/bin/db2xml
/usr/bin/dbnochunks
/usr/share/doc/packages/docbook-toys
/usr/share/doc/packages/docbook-toys/AUTHORS
/usr/share/doc/packages/docbook-toys/COPYING
/usr/share/doc/packages/docbook-toys/ChangeLog
/usr/share/doc/packages/docbook-toys/NEWS
/usr/share/doc/packages/docbook-toys/README
/usr/share/doc/packages/docbook-toys/README.SuSE
/usr/share/doc/packages/docbook-toys/THANKS
/usr/share/doc/packages/docbook-toys/TODO
/usr/share/doc/packages/docbook-toys/test
/usr/share/doc/packages/docbook-toys/test/Makefile
/usr/share/doc/packages/docbook-toys/test/Makefile.am
/usr/share/doc/packages/docbook-toys/test/Makefile.in
/usr/share/doc/packages/docbook-toys/test/Makefile.tips
/usr/share/doc/packages/docbook-toys/test/art.dsl
/usr/share/doc/packages/docbook-toys/test/test.sgml
/usr/share/doc/packages/docbook-toys/test/tips.sgml
/usr/share/doc/packages/docbook-toys/texmf.conf.diff
/usr/share/sgml/docbook/docbook-toys
/usr/share/sgml/docbook/docbook-toys/docbook-sloppy.dcl
/usr/share/sgml/docbook/docbook-toys/gdp-both.dsl
/usr/share/sgml/docbook/docbook-toys/suse-both.dsl

----------------------------------------------

jmayer(a)alice:~/work/wine/wine/documentation> db2html --help
Usage: db2html [OPTION]... FILE.sgml
Run a DocBook SGML document FILE.sgml through various programs.

If a long option shows an argument as mandatory, then it is mandatory
for the equivalent short option also.  Similarly for optional arguments.

Options:
  --help                  display this help and exit
  -v, --version           output version information and exit

  -x                      trace the shell script

Output formats:
  -d, --dvi               output DVI
  -f, --fot               output FOT
  -h, --html              output HTML
  -m, --mif               output MIF
  --pdf                   output PDF
  -p, --ps, --postscript  output PostScript
  -r, --rtf               output RTF
  -t, --tex               output TeX
  -X, --xml               output XML (DocBook)
      --xencoding VAR     set XML output encoding (default: iso-8859-1)
      --xoptions VAR      add XML output options; e.g., "-xempty -xlower"
                            (default)

HTML:
  --nochunks              don't produce HTML subdocuments; output to stdout

General options:
  -S, --strict            use the SGML declaration coming with the DocBook DTDs
                            (no minimizations are allowed)
  -j, --jade VAR...       set "jade" variables; e.g., "-V %shade-verbatim%"
  -c, --catalog FILE      use FILE as the catalog
  -s, --style FILE        use FILE as driver style
  -V, --validate          validate (sloppy); without "--strict" allow
                            minimizations
  -W, --validate-strict   validate (strict); implies "--strict"
  -o, --use-openjade      use OpenJade binaries

Only the last specified output format will be produced.

The script will automatically use FILE.dsl as a driver style if it is found in
the same directory as FILE.sgml.

DocBook XML version 4 input files will be properly processed, too.

Please, report bugs to Karl Eichwalder <keichwa(a)gmx.net>.

----------------------------------------------


  Ciao
         JÖrg
--
Joerg Mayer                                          <jmayer(a)loplof.de>
I found out that "pro" means "instead of" (as in proconsul). Now I know
what proactive means.

[Fwd: [Bug 688] - make documentation produces only files as 'x6772.html']

[Vincent Béron]

Le sam 23/11/2002 à 12:58, Joerg Mayer a écrit :
> On Sat, Nov 23, 2002 at 09:55:32AM -0700, Tony Lambregts wrote:
> > Ok  heres what I have found. "db2html -d ../faq-plain.dsl wine-faq.sgml 
> > " works, However if I use "db2html -d ./faq-plain.dsl wine-faq.sgml " it 
> > blows chunks. as I reported.
> >
> > So the change to two dots works, which makes sense, therfore I changed 
> > the Makefile so that  SRCDIR = .. and re-ran "make html" and produces 
> > the html beautifully.
>
> Fails for me too:
>
> jmayer(a)alice:~/work/wine/wine/documentation> make everything
> db2html -d ./default.dsl -o wine-devel wine-devel.sgml
> Filename suffix "dsl" ambiguous: ./default.dsl
> make: *** [wine-devel/index.html] Fehler 1

Do'h!
> -d, --dvi               output DVI
>   -s, --style FILE        use FILE as driver style
> Comes from this. -d is used for DVI output for your db2html, while -d is
> used to specify the style file in my db2html (RH).

Seems we don't have much choice but to skip db2html and directly drive
either jw (another jade wrapper) or even jade.

I'll try to gather what I can on the specifics of each distro. Expect a
patch in the next few days.

Vincent