Hello! See $SUBJECT for my little problem.
The real fix would be making a port for docbook-xsl (current version 1.68.1, from http://sourceforge.net/projects/docbook/), then making that damn thing calling something like xsltproc --nonet --novalid /somewhere.../manpages/docbook.xsl dia.dbk in w-dia-0.94/dia-0.94/doc/en (perhaps one could convince that configure script to find ../manpages/docbook.xsl by itself; xsltproc would be from the libxslt port/package). A workaround would be substituting a pre-made nroff dia.1 in the patch phase. I'll attach a dia.1 generated in the way mentioned above. Alternatively, instead of putting a file in there from .../files, one could just use the patches mechanism, which is my workaround. patch-doc_en_dia_1 attached, too. Kind regards, Hannah.
.\"Generated by db2man.xsl. Don't modify this, modify the source. .de Sh \" Subsection .br .if t .Sp .ne 5 .PP \fB\\$1\fR .PP .. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Ip \" List item .br .ie \\n(.$>=3 .ne \\$3 .el .ne 3 .IP "\\$1" \\$2 .. .TH "DIA" 1 "1999-07-03" "" "" .SH NAME dia \- a diagram drawing program .SH "SYNOPSIS" .ad l .hy 0 .HP 4 \fBdia\fR [\fB\-c\fR] [\fB\-\-credits\fR] [\fB\-e\ \fIOUTPUT\fR\fR] [\fB\-\-export=\fIOUTPUT\fR\fR] [\fB\-h\fR] [\fB\-\-help\fR] [\fB\-n\fR] [\fB\-\-nosplash\fR] [\fB\-s\ \fIWxH\fR\fR] [\fB\-\-size=\fIWxH\fR\fR] [\fB\-t\ \fIFORMAT\fR\fR] [\fB\-\-export\-to\-format=\fIFORMAT\fR\fR] [\fB\-v\fR] [\fB\-\-version\fR] [file\ \&.\&.\&.] .ad .hy .SH "DESCRIPTION" .PP \fBDia\fR is used to create diagrams\&. Dia has a number of basic tools, like lines and boxes but can also dynamically load \fIsheets\fR\&. A sheet is a collection of tools that are used in a certain type of diagram\&. .PP Most diagram objects in \fBDia\fR has \fIhandles\fR\&. Lines can be connected to these handles and this way graph structures can be formed\&. When objects are moved or resized the connections will follow the objects\&. .PP Diagrams drawn in \fBDia\fR can be exported PostScript\&. .SH "OPTIONS" .PP \fBDia\fR accepts the following options: .TP \fB\-c\fR \fB\-\-credits\fR Display credits list and exit\&. .TP \fB\-e \fIOUTPUT\fR\fR \fB\-\-export=\fIOUTPUT\fR\fR Export loaded file to OUTPUT and exit\&. .TP \fB\-h\fR \fB\-\-help\fR Display a list of all commandline options\&. .TP \fB\-n\fR \fB\-\-nosplash\fR Do not show the splash screen\&. .TP \fB\-s \fIWxH\fR\fR \fB\-\-size=\fIWxH\fR\fR Export loaded file in decimal given width and/or height\&. It is allowed to only select width or height\&. E\&.g\&. \fB\-\-size=\fI520x\fR\fR exports an image that is 520 pixels wide, while \fB\-\-size=\fIx900\fR\fR exports an image of 900 pixels height\&. .RS .Sh "Note" This option is currently only implemented for the PNG export filter\&. .RE .TP \fB\-t \fIFORMAT\fR\fR \fB\-\-export\-to\-format=\fIFORMAT\fR\fR Export loaded file in FORMAT and exit\&. Format are described below\&. .TP \fB\-v\fR \fB\-\-version\fR Display \fBdia\fR version and exit\&. .SH "EXPORT FORMATS" .PP The following export formats are supported by \fBdia\fR\&. .TP 3 \(bu cgm (Computer Graphics Metafile, ISO 8632) .TP \(bu dia (Native dia diagram) .TP \(bu dxf (Drawing Interchange File) .TP \(bu eps or epsi oreps\-builtin or eps\-pango (Encapsulated PostScript) The format specifications eps,epsi, and eps\-pango all use the font renderer of the Pango library, whileeps\-builtin uses a dia specific font renderer\&. If you have problems with Pango rendering, e\&.g\&. Unicode, try eps\-builtin instead\&. .TP \(bu fig (XFig format) .TP \(bu mp (TeX MetaPost macros) .TP \(bu plt or hpgl (HP Graphics Language) .TP \(bu png (Portable Network Graphics) .TP \(bu shape (Dia shape file) .TP \(bu svg (Scalable Vector Graphics) .TP \(bu tex (TeX PSTricks macros) .TP \(bu wpg (WordPerfect Graphics) .TP \(bu wmf (Windows MetaFile) .LP .SH "FILES" .PP \fBdia\fR creates a directory \fI\&.dia\fR in the user's home, which contains different files to store user preferences\&. To reset \fBdia\fR to it's default behaviour, just remove the respective file: .TP 3 \(bu \fIdefaults\&.dia\fR: contains default values for elements (XML format)\&. .TP \(bu \fIdiarc\fR: keeps\fBdia\fR preferences (ASCII)\&. .TP \(bu \fIhistory\fR: keeps the list of last edited diagrams (ASCII)\&. .TP \(bu \fImenurc\fR: contains an automated accelerator map dump (Lisp)\&. .TP \(bu \fIpersistence\fR: contains GUI information, e\&.g\&. open windows (XML)\&. .TP \(bu \fIpluginrc\fR: the list of loaded plugins (XML)\&. .LP .SH "SEE ALSO" .PP Pango: \fIhttp://www.pango.org/\fR .PP X (1) .SH "COPYRIGHT" .PP Copyright 1999 Alexander Larsson\&. .PP Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation\&. .SH "AUTHORS" .PP Alexander Larsson .PP This manual was written by Fredrik Hallenberg\&. .SH AUTHORS Fredrik Hallenberg, W\&. Borgert.
$OpenBSD$ Just a sucking workaround for a HTML manual page instead of nroff, generated from docbook-xml-stuff. --- doc/en/dia.1.orig Tue Jul 12 18:07:12 2005 +++ doc/en/dia.1 Tue Jul 12 18:07:39 2005 @@ -1,51 +1,179 @@ -<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>dia</title><meta name="generator" content="DocBook XSL Stylesheets V1.48"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="id2750613"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>dia — a diagram drawing program</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><tt>dia</tt> [<tt>-c</tt>] [<tt>--credits</tt>] [<tt>-e <i><tt>OUTPUT</tt></i></tt>] [<tt>--export=<i><tt>OUTPUT</tt></i></tt>] [<tt>-h</tt>] [<tt>--help</tt>] [<tt>-n</tt>] [<tt>--nosplash</tt>] [<tt>-s <i><tt>WxH</tt></i></tt>] [<tt>--size=<i><tt>WxH</tt></i></tt>] [<tt>-t <i><tt>FORMAT</tt></i></tt>] [<tt>--export-to-format=<i><tt>FORMAT</tt></i></tt>] [<tt>-v</tt>] [<tt>--version</tt>] [file ...]</p></div></div><div class="refsect1"><h2>Description</h2><p><b>Dia</b> is used to create diagrams. Dia has - a number of basic tools, like lines and boxes but can also - dynamically load <span class="emphasis"><i>sheets</i></span>. A sheet is a - collection of tools that are used in a certain type of - diagram.</p><p>Most diagram objects in <b>Dia</b> has - <span class="emphasis"><i>handles</i></span>. Lines can be connected to these - handles and this way graph structures can be formed. When objects - are moved or resized the connections will follow the - objects.</p><p>Diagrams drawn in <b>Dia</b> can be exported - PostScript.</p></div><div class="refsect1"><h2>Options</h2><p><b>Dia</b> accepts the following options:</p><div class="variablelist"><dl><dt><span class="term"><tt>-c</tt> - <tt>--credits</tt></span></dt><dd><p>Display credits list and exit.</p></dd><dt><span class="term"><tt>-e <i><tt>OUTPUT</tt></i></tt> - <tt>--export=<i><tt>OUTPUT</tt></i></tt></span></dt><dd><p>Export loaded file to OUTPUT and exit.</p></dd><dt><span class="term"><tt>-h</tt> - <tt>--help</tt></span></dt><dd><p>Display a list of all commandline options.</p></dd><dt><span class="term"><tt>-n</tt> - <tt>--nosplash</tt></span></dt><dd><p>Do not show the splash screen.</p></dd><dt><span class="term"><tt>-s <i><tt>WxH</tt></i></tt> - <tt>--size=<i><tt>WxH</tt></i></tt></span></dt><dd><p>Export loaded file in decimal given width and/or - height. It is allowed to only select width or height. - E.g. <tt>--size=<i><tt>520x</tt></i></tt> - exports an image that is 520 pixels wide, while - <tt>--size=<i><tt>x900</tt></i></tt> - exports an image of 900 pixels height.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This option is currently only implemented for the - PNG export filter.</p></div></dd><dt><span class="term"><tt>-t <i><tt>FORMAT</tt></i></tt> - <tt>--export-to-format=<i><tt>FORMAT</tt></i></tt></span></dt><dd><p>Export loaded file in FORMAT and exit. Format are - described below.</p></dd><dt><span class="term"><tt>-v</tt> - <tt>--version</tt></span></dt><dd><p>Display <b>dia</b> version and exit.</p></dd></dl></div></div><div class="refsect1"><h2>Export Formats</h2><p>The following export formats are supported by - <b>dia</b>.</p><div class="itemizedlist"><ul type="disc"><li><p><tt>cgm</tt> (Computer Graphics Metafile, ISO - 8632)</p></li><li><p><tt>dia</tt> (Native dia diagram)</p></li><li><p><tt>dxf</tt> (Drawing Interchange File)</p></li><li><p><tt>eps</tt> or <tt>epsi</tt> or - <tt>eps-builtin</tt> or <tt>eps-pango</tt> - (Encapsulated PostScript)</p><p>The format specifications <tt>eps</tt>, - <tt>epsi</tt>, and <tt>eps-pango</tt> all - use the font renderer of the Pango library, while - <tt>eps-builtin</tt> uses a dia specific font - renderer. If you have problems with Pango rendering, - e.g. Unicode, try <tt>eps-builtin</tt> - instead.</p></li><li><p><tt>fig</tt> (XFig format)</p></li><li><p><tt>mp</tt> (TeX MetaPost macros)</p></li><li><p><tt>plt</tt> or <tt>hpgl</tt> (HP - Graphics Language)</p></li><li><p><tt>png</tt> (Portable Network - Graphics)</p></li><li><p><tt>shape</tt> (Dia shape file)</p></li><li><p><tt>svg</tt> (Scalable Vector Graphics)</p></li><li><p><tt>tex</tt> (TeX PSTricks macros)</p></li><li><p><tt>wpg</tt> (WordPerfect Graphics)</p></li><li><p><tt>wmf</tt> (Windows MetaFile)</p></li></ul></div></div><div class="refsect1"><h2>Files</h2><p><b>dia</b> creates a directory - <tt>.dia</tt> in the user's home, which contains - different files to store user preferences. To reset - <b>dia</b> to it's default behaviour, just remove - the respective file:</p><div class="itemizedlist"><ul type="disc"><li><p><tt>defaults.dia</tt>: contains default - values for elements (XML format).</p></li><li><p><tt>diarc</tt>: keeps - <b>dia</b> preferences (ASCII).</p></li><li><p><tt>history</tt>: keeps the list of last - edited diagrams (ASCII).</p></li><li><p><tt>menurc</tt>: contains an automated - accelerator map dump (Lisp).</p></li><li><p><tt>persistence</tt>: contains GUI - information, e.g. open windows (XML).</p></li><li><p><tt>pluginrc</tt>: the list of loaded - plugins (XML).</p></li></ul></div></div><div class="refsect1"><h2>See Also</h2><p><a href="http://www.pango.org/" target="_top">Pango</a></p><p>X (1)</p></div><div class="refsect1"><h2>Copyright</h2><p>Copyright 1999 Alexander Larsson.</p><p>Permission to use, copy, modify, and distribute this - software and its documentation for any purpose and without fee is - hereby granted, provided that the above copyright notice appear in - all copies and that both that copyright notice and this permission - notice appear in supporting documentation.</p></div><div class="refsect1"><h2>Authors</h2><p><span class="author">Alexander Larsson</span></p><p>This manual was written by - <span class="author">Fredrik Hallenberg</span>.</p></div></div></body></html> +.\"Generated by db2man.xsl. Don't modify this, modify the source. +.de Sh \" Subsection +.br +.if t .Sp +.ne 5 +.PP +\fB\\$1\fR +.PP +.. +.de Sp \" Vertical space (when we can't use .PP) +.if t .sp .5v +.if n .sp +.. +.de Ip \" List item +.br +.ie \\n(.$>=3 .ne \\$3 +.el .ne 3 +.IP "\\$1" \\$2 +.. +.TH "DIA" 1 "1999-07-03" "" "" +.SH NAME +dia \- a diagram drawing program +.SH "SYNOPSIS" +.ad l +.hy 0 +.HP 4 +\fBdia\fR [\fB\-c\fR] [\fB\-\-credits\fR] [\fB\-e\ \fIOUTPUT\fR\fR] [\fB\-\-export=\fIOUTPUT\fR\fR] [\fB\-h\fR] [\fB\-\-help\fR] [\fB\-n\fR] [\fB\-\-nosplash\fR] [\fB\-s\ \fIWxH\fR\fR] [\fB\-\-size=\fIWxH\fR\fR] [\fB\-t\ \fIFORMAT\fR\fR] [\fB\-\-export\-to\-format=\fIFORMAT\fR\fR] [\fB\-v\fR] [\fB\-\-version\fR] [file\ \&.\&.\&.] +.ad +.hy + +.SH "DESCRIPTION" + +.PP +\fBDia\fR is used to create diagrams\&. Dia has a number of basic tools, like lines and boxes but can also dynamically load \fIsheets\fR\&. A sheet is a collection of tools that are used in a certain type of diagram\&. + +.PP +Most diagram objects in \fBDia\fR has \fIhandles\fR\&. Lines can be connected to these handles and this way graph structures can be formed\&. When objects are moved or resized the connections will follow the objects\&. + +.PP +Diagrams drawn in \fBDia\fR can be exported PostScript\&. + +.SH "OPTIONS" + +.PP +\fBDia\fR accepts the following options: + +.TP +\fB\-c\fR \fB\-\-credits\fR +Display credits list and exit\&. + +.TP +\fB\-e \fIOUTPUT\fR\fR \fB\-\-export=\fIOUTPUT\fR\fR +Export loaded file to OUTPUT and exit\&. + +.TP +\fB\-h\fR \fB\-\-help\fR +Display a list of all commandline options\&. + +.TP +\fB\-n\fR \fB\-\-nosplash\fR +Do not show the splash screen\&. + +.TP +\fB\-s \fIWxH\fR\fR \fB\-\-size=\fIWxH\fR\fR +Export loaded file in decimal given width and/or height\&. It is allowed to only select width or height\&. E\&.g\&. \fB\-\-size=\fI520x\fR\fR exports an image that is 520 pixels wide, while \fB\-\-size=\fIx900\fR\fR exports an image of 900 pixels height\&. + +.RS +.Sh "Note" +This option is currently only implemented for the PNG export filter\&. + +.RE + +.TP +\fB\-t \fIFORMAT\fR\fR \fB\-\-export\-to\-format=\fIFORMAT\fR\fR +Export loaded file in FORMAT and exit\&. Format are described below\&. + +.TP +\fB\-v\fR \fB\-\-version\fR +Display \fBdia\fR version and exit\&. + +.SH "EXPORT FORMATS" + +.PP +The following export formats are supported by \fBdia\fR\&. + +.TP 3 +\(bu +cgm (Computer Graphics Metafile, ISO 8632) +.TP +\(bu +dia (Native dia diagram) +.TP +\(bu +dxf (Drawing Interchange File) +.TP +\(bu +eps or epsi oreps\-builtin or eps\-pango (Encapsulated PostScript) + +The format specifications eps,epsi, and eps\-pango all use the font renderer of the Pango library, whileeps\-builtin uses a dia specific font renderer\&. If you have problems with Pango rendering, e\&.g\&. Unicode, try eps\-builtin instead\&. +.TP +\(bu +fig (XFig format) +.TP +\(bu +mp (TeX MetaPost macros) +.TP +\(bu +plt or hpgl (HP Graphics Language) +.TP +\(bu +png (Portable Network Graphics) +.TP +\(bu +shape (Dia shape file) +.TP +\(bu +svg (Scalable Vector Graphics) +.TP +\(bu +tex (TeX PSTricks macros) +.TP +\(bu +wpg (WordPerfect Graphics) +.TP +\(bu +wmf (Windows MetaFile) +.LP + +.SH "FILES" + +.PP +\fBdia\fR creates a directory \fI\&.dia\fR in the user's home, which contains different files to store user preferences\&. To reset \fBdia\fR to it's default behaviour, just remove the respective file: + +.TP 3 +\(bu +\fIdefaults\&.dia\fR: contains default values for elements (XML format)\&. +.TP +\(bu +\fIdiarc\fR: keeps\fBdia\fR preferences (ASCII)\&. +.TP +\(bu +\fIhistory\fR: keeps the list of last edited diagrams (ASCII)\&. +.TP +\(bu +\fImenurc\fR: contains an automated accelerator map dump (Lisp)\&. +.TP +\(bu +\fIpersistence\fR: contains GUI information, e\&.g\&. open windows (XML)\&. +.TP +\(bu +\fIpluginrc\fR: the list of loaded plugins (XML)\&. +.LP + +.SH "SEE ALSO" + +.PP +Pango: \fIhttp://www.pango.org/\fR + +.PP +X (1) + +.SH "COPYRIGHT" + +.PP +Copyright 1999 Alexander Larsson\&. + +.PP +Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation\&. + +.SH "AUTHORS" + +.PP +Alexander Larsson + +.PP +This manual was written by Fredrik Hallenberg\&. + +.SH AUTHORS +Fredrik Hallenberg, W\&. Borgert.