* Creating man pages from Docbook - docbook2man does not generate man pages.
@ 2003-11-17 17:06 Hans Deragon
2003-11-17 17:17 ` Tim Waugh
0 siblings, 1 reply; 5+ messages in thread
From: Hans Deragon @ 2003-11-17 17:06 UTC (permalink / raw)
To: docbook-tools-discuss
Greetings.
Newbie here with docbook. Docbook is easy and I get docbook2pdf, docbook2ps
and docbook2html working marvelously. However, when I run docbook2man, only the
following two files are created:
-rw-r--r-- 1 qhander qhander 0 Nov 17 11:11 manpage.links
-rw-r--r-- 1 qhander qhander 27 Nov 17 11:11 manpage.refs
There is no real man page created. I search for the web for some HowTos, but
no success. What is missing to generate man pages?
I am running docbook version 3.1-3.
Best regards,
Hans Deragon
--
Consultant en informatique/Software Consultant
Deragon Informatique inc. Open source:
http://www.deragon.biz http://swtmvcwrapper.sourceforge.net
mailto://hans@deragon.biz http://autopoweroff.sourceforge.net
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Creating man pages from Docbook - docbook2man does not generate man pages.
2003-11-17 17:06 Creating man pages from Docbook - docbook2man does not generate man pages Hans Deragon
@ 2003-11-17 17:17 ` Tim Waugh
2003-11-17 17:31 ` Hans Deragon
0 siblings, 1 reply; 5+ messages in thread
From: Tim Waugh @ 2003-11-17 17:17 UTC (permalink / raw)
To: Hans Deragon; +Cc: docbook-tools-discuss
[-- Attachment #1: Type: text/plain, Size: 628 bytes --]
On Mon, Nov 17, 2003 at 12:04:53PM -0500, Hans Deragon wrote:
> Newbie here with docbook. Docbook is easy and I get docbook2pdf,
> docbook2ps and docbook2html working marvelously. However, when I run
> docbook2man, only the following two files are created:
>
> -rw-r--r-- 1 qhander qhander 0 Nov 17 11:11 manpage.links
> -rw-r--r-- 1 qhander qhander 27 Nov 17 11:11 manpage.refs
>
> There is no real man page created. I search for the web for some HowTos,
> but no success. What is missing to generate man pages?
Perhaps you don't have any <refentry> elements?
Tim.
*/
[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Creating man pages from Docbook - docbook2man does not generate man pages.
2003-11-17 17:17 ` Tim Waugh
@ 2003-11-17 17:31 ` Hans Deragon
2003-11-17 17:40 ` Tim Waugh
0 siblings, 1 reply; 5+ messages in thread
From: Hans Deragon @ 2003-11-17 17:31 UTC (permalink / raw)
Cc: docbook-tools-discuss
Tim Waugh wrote:
> On Mon, Nov 17, 2003 at 12:04:53PM -0500, Hans Deragon wrote:
>
>
>> Newbie here with docbook. Docbook is easy and I get docbook2pdf,
>> docbook2ps and docbook2html working marvelously. However, when I run
>>docbook2man, only the following two files are created:
>>
>>-rw-r--r-- 1 qhander qhander 0 Nov 17 11:11 manpage.links
>>-rw-r--r-- 1 qhander qhander 27 Nov 17 11:11 manpage.refs
>>
>> There is no real man page created. I search for the web for some HowTos,
>> but no success. What is missing to generate man pages?
>
>
> Perhaps you don't have any <refentry> elements?
>
> Tim.
> */
Thanks for the tip, but could you point me to a howto for creating man pages
with docbook? Is it actually possible from a same docbook xml to create man
pages and a normal pdf document? Or must I have one special docbook for man
pages and another one for the other formats? Ideally, I want to be able to
generate a nice PDF manual and a man page from the same source, without having
to duplicate text.
Sincerely,
Hans Deragon
--
Consultant en informatique/Software Consultant
Deragon Informatique inc. Open source:
http://www.deragon.biz http://swtmvcwrapper.sourceforge.net
mailto://hans@deragon.biz http://autopoweroff.sourceforge.net
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Creating man pages from Docbook - docbook2man does not generate man pages.
2003-11-17 17:31 ` Hans Deragon
@ 2003-11-17 17:40 ` Tim Waugh
2003-11-17 18:29 ` John Fleck
0 siblings, 1 reply; 5+ messages in thread
From: Tim Waugh @ 2003-11-17 17:40 UTC (permalink / raw)
To: Hans Deragon; +Cc: docbook-tools-discuss
[-- Attachment #1: Type: text/plain, Size: 781 bytes --]
On Mon, Nov 17, 2003 at 12:30:40PM -0500, Hans Deragon wrote:
> Thanks for the tip, but could you point me to a howto for creating
> man pages with docbook? Is it actually possible from a same docbook
> xml to create man pages and a normal pdf document? Or must I have
> one special docbook for man pages and another one for the other
> formats? Ideally, I want to be able to generate a nice PDF manual
> and a man page from the same source, without having to duplicate
> text.
What do you mean by 'normal pdf document'? PDF format output for
refentry looks a lot like you would expect man pages to appear, since
that is how a refentry is structured. You can of course have filling
text in between refentry elements, or as an introduction, or whatever
if you wish.
Tim.
*/
[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Creating man pages from Docbook - docbook2man does not generate man pages.
2003-11-17 17:40 ` Tim Waugh
@ 2003-11-17 18:29 ` John Fleck
0 siblings, 0 replies; 5+ messages in thread
From: John Fleck @ 2003-11-17 18:29 UTC (permalink / raw)
To: Tim Waugh; +Cc: Hans Deragon, docbook-tools-discuss
On Mon, Nov 17, 2003 at 05:40:05PM +0000, Tim Waugh wrote:
> On Mon, Nov 17, 2003 at 12:30:40PM -0500, Hans Deragon wrote:
>
> > Thanks for the tip, but could you point me to a howto for creating
> > man pages with docbook? Is it actually possible from a same docbook
> > xml to create man pages and a normal pdf document? Or must I have
> > one special docbook for man pages and another one for the other
> > formats? Ideally, I want to be able to generate a nice PDF manual
> > and a man page from the same source, without having to duplicate
> > text.
>
If you'd like to see an example of a docbook man page:
http://cvs.gnome.org/bonsai/cvsblame.cgi?file=libxml2%2Fdoc/xmllint.xml&rev=&root=/cvs/gnome
You can then use it to build html and pdf as you would any other DocBook
source.
Cheers,
John
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2003-11-17 18:29 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2003-11-17 17:06 Creating man pages from Docbook - docbook2man does not generate man pages Hans Deragon
2003-11-17 17:17 ` Tim Waugh
2003-11-17 17:31 ` Hans Deragon
2003-11-17 17:40 ` Tim Waugh
2003-11-17 18:29 ` John Fleck
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).