how to convert man pages?
[Top] [All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index] [Thread Index]
Hi, the package of offlineimap for my distribution (archlinux) does not
install the man pages, because they are unable to convert
offlineimap.sgml to a standard man page. So I am trying to do this
conversion myself, but the conversion fails for me too.
I have installed docbook2x (including docbook2man) version 0.8.8 and the
perl module xml-sax version 0.16, then I try to run:
docbook2man offlineimap.sgml
But what I get is simply a bunch of errors:
offlineimap.sgml:1: parser error : SystemLiteral " or ' expected
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
^
offlineimap.sgml:1: parser error : SYSTEM or PUBLIC, the URI is missing
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
^
offlineimap.sgml:50: parser error : Entity 'OfflineIMAP' not defined
<para>&OfflineIMAP; is a tool to simplify your e-mail
^
offlineimap.sgml:51: parser error : Entity 'OfflineIMAP' not defined
reading. With &OfflineIMAP;, you can read the same mailbox
^
offlineimap.sgml:56: parser error : Entity 'OfflineIMAP' not defined
computer as well. &OfflineIMAP; is also useful if you want to
^
offlineimap.sgml:61: parser error : Entity 'OfflineIMAP' not defined
<para>&OfflineIMAP; is <emphasis>FAST</emphasis>; it synchronizes
^
offlineimap.sgml:66: parser error : Entity 'OfflineIMAP' not defined
at all. Unlike other mail tools, &OfflineIMAP; features a
^
offlineimap.sgml:72: parser error : Entity 'OfflineIMAP' not defined
<para>&OfflineIMAP; is <emphasis>FLEXIBLE</emphasis>; you can
^
offlineimap.sgml:84: parser error : Entity 'OfflineIMAP' not defined
<para>&OfflineIMAP; is <emphasis>SAFE</emphasis>; it uses an
^
offlineimap.sgml:89: parser error : Entity 'OfflineIMAP' not defined
testing of &OfflineIMAP; pre-release, development, and beta
^
offlineimap.sgml:90: parser error : Entity 'OfflineIMAP' not defined
releases. Of course, legally speaking, &OfflineIMAP; comes
^
offlineimap.sgml:98: parser error : Entity 'OfflineIMAP' not defined
<para>&OfflineIMAP; traditionally
^
offlineimap.sgml:102: parser error : Entity 'OfflineIMAP' not defined
that the mail comes from IMAP. &OfflineIMAP; will detect
^
offlineimap.sgml:108: parser error : Entity 'OfflineIMAP' not defined
With &OfflineIMAP; 4.0, a powerful new ability has been
^
offlineimap.sgml:114: parser error : Entity 'OfflineIMAP' not defined
machine, and point both &OfflineIMAP; and their mail reader
^
offlineimap.sgml:116: parser error : Entity 'OfflineIMAP' not defined
reader's own IMAP support since &OfflineIMAP; supports many
^
offlineimap.sgml:127: parser error : Entity 'OfflineIMAP' not defined
<para>If you have already installed &OfflineIMAP; system-wide,
^
offlineimap.sgml:129: parser error : Entity 'OfflineIMAP' not defined
for setting up &OfflineIMAP; for the first time is quite
^
offlineimap.sgml:138: parser error : Entity 'OfflineIMAP' not defined
map.conf.minimal</filename>) that is a basic example of setting of
&OfflineIMAP;
^
offlineimap.sgml:170: parser error : Entity 'OfflineIMAP' not defined
<para>To run &OfflineIMAP;, you just have to say
^
offlineimap.sgml:175: parser error : Entity 'OfflineIMAP' not defined
make &OfflineIMAP; FIVE TIMES FASTER FOR JUST $19.95 (err, well,
^
offlineimap.sgml:190: parser error : Entity 'OfflineIMAP' not defined
installation. You can download the latest version of
&OfflineIMAP; from
^
offlineimap.sgml:191: parser error : Entity 'OfflineIMAP' not defined
<ulink url="http://software.complete.org/offlineimap/";>the
&OfflineIMAP;
^
offlineimap.sgml:198: parser error : Entity 'OfflineIMAP' not defined
<para>In order to use &OfflineIMAP;, you need to have these
conditions
^
offlineimap.sgml:232: parser error : Entity 'OfflineIMAP' not defined
with &OfflineIMAP;. If you do not have a mail reader
^
offlineimap.sgml:234: parser error : Entity 'OfflineIMAP' not defined
IMAP server and point both &OfflineIMAP; and your mail
^
offlineimap.sgml:245: parser error : Entity 'OfflineIMAP' not defined
&OfflineIMAP; by simply running the following command as root:
^
offlineimap.sgml:252: parser error : Entity 'OfflineIMAP' not defined
ge from the <ulink
url="http://software.complete.org/offlineimap/";>&OfflineIMAP;
^
offlineimap.sgml:256: parser error : Opening and ending tag mismatch:
xref line 254 and para
</para>
^
offlineimap.sgml:257: parser error : Opening and ending tag mismatch:
para line 250 and refsect2
</refsect2>
^
offlineimap.sgml:275: parser error : Opening and ending tag mismatch:
xref line 273 and para
</para>
^ </refsect2>
^
offlineimap.sgml:289: parser error : Entity 'OfflineIMAP' not defined
<para>When you want to run &OfflineIMAP;, you will issue the
^
offlineimap.sgml:295: parser error : Opening and ending tag mismatch:
refsect2 line 259 and refsect1
</refsect1>
^
offlineimap.sgml:300: parser error : Entity 'OfflineIMAP' not defined
&OfflineIMAP; is regulated by a configuration file that is
normally
^
offlineimap.sgml:301: parser error : Entity 'OfflineIMAP' not defined
stored in <filename>~/.offlineimaprc</filename>. &OfflineIMAP;
^
offlineimap.sgml:305: parser error : Entity 'OfflineIMAP' not defined
to run &OfflineIMAP;. Full documentation for the configuration
file
^
offlineimap.sgml:309: parser error : Entity 'OfflineIMAP' not defined
&OfflineIMAP; also ships a file named
^
offlineimap.sgml:322: parser error : Entity 'OfflineIMAP' not defined
&OfflineIMAP;.
^
offlineimap.sgml:336: parser error : Entity 'OfflineIMAP' not defined
<listitem><para>Sets &OfflineIMAP; into profile mode. The
program
^
offlineimap.sgml:435: parser error : Entity 'OfflineIMAP' not defined
<para>&OfflineIMAP; has a pluggable user interface system that
lets you ch
^
offlineimap.sgml:449: parser error : Entity 'OfflineIMAP' not defined
informative of the overall picture of what &OfflineIMAP;
^
offlineimap.sgml:451: parser error : Entity 'OfflineIMAP' not defined
&OfflineIMAP;.
^
offlineimap.sgml:462: parser error : Entity 'OfflineIMAP' not defined
of execution -- that is, a particular task that &OfflineIMAP;
^
offlineimap.sgml:577: parser error : Entity 'OfflineIMAP' not defined
Noninteractive.Basic is designed for situations in which
&OfflineIMAP;
^
offlineimap.sgml:620: parser error : Entity 'OfflineIMAP' not defined
This example shows you how to set up &OfflineIMAP; to
^
offlineimap.sgml:634: parser error : Opening and ending tag mismatch:
property line 634 and unparseable
<propertofflineimap.sgml:658: parser error : Entity
'OfflineIMAP' not defined
<para>Some users with a UW-IMAPD server need to use &OfflineIMAP;'s
^
offlineimap.sgml:698: parser error : Entity 'OfflineIMAP' not defined
<para>You can have &OfflineIMAP;
^
offlineimap.sgml:773: parser error : Entity 'OfflineIMAP' not defined
UID. UIDs are an integral part of &OfflineIMAP;'s
synchronization
^
offlineimap.sgml:782: parser error : Entity 'OfflineIMAP' not defined
&OfflineIMAP; might still have the UIDs from the previous
folder by the
^
offlineimap.sgml:783: parser error : Entity 'OfflineIMAP' not defined
same name stored. &OfflineIMAP; will detect this condition
and skip the
^
offlineimap.sgml:794: parser error : Opening and ending tag mismatch:
replaceable line 794 and unparseable
rm -r ~/.offlineimap/Account-<replaceable>AccountName</>/LocalStatus/INBOX
^
offlineimap.sgml:795: parser error : Opening and ending tag mismatch:
replaceable line 795 and unparseable
rm -r
~/.offlineimap/Repository-<replaceable>RemoteRepositoryName</>/FolderValid
^
offlineimap.sgml:803: parser error : Entity 'OfflineIMAP' not defined
<para>Next time you run &OfflineIMAP;, it will re-download
^
offlineimap.sgml:813: parser error : Entity 'OfflineIMAP' not defined
this category. &OfflineIMAP; is incompatible with such servers.
^
offlineimap.sgml:814: parser error : Entity 'OfflineIMAP' not defined
Using &OfflineIMAP; with them will not destroy any mail, but
at the same time
^
offlineimap.sgml:815: parser error : Entity 'OfflineIMAP' not defined
it will not actually synchronize it either. (&OfflineIMAP;
will detect
^
offlineimap.sgml:821: parser error : Entity 'OfflineIMAP' not defined
url="http://lists.complete.org/offlineimap@xxxxxxxxxxxx/";>&OfflineIMAP;
^
offlineimap.sgml:846: parser error : Entity 'OfflineIMAP' not defined
<para>&OfflineIMAP; does a two-way synchronization. That is,
if you
^
offlineimap.sgml:850: parser error : Entity 'OfflineIMAP' not defined
do this with &OfflineIMAP;, remember to also remove your
local status
^
offlineimap.sgml:851: parser error : Entity 'OfflineIMAP' not defined
ache (<filename>~/.offlineimap</filename> by default). Otherwise,
&OfflineIMAP;
^
offlineimap.sgml:861: parser error : Entity 'OfflineIMAP' not defined
<para>&OfflineIMAP; is not designed to have several instances
(for instance, a
y>localfo ^
offlineimap.sgml:863: parser error : Entity 'OfflineIMAP' not defined
abort if another &OfflineIMAP; is already running. If you need
^
offlineimap.sgml:875: parser error : Entity 'OfflineIMAP' not defined
to a folder locally, &OfflineIMAP;
^
offlineimap.sgml:878: parser error : Entity 'OfflineIMAP' not defined
not return something useful, &OfflineIMAP;
^
offlineimap.sgml:883: parser error : Entity 'OfflineIMAP' not defined
&OfflineIMAP; makes sure that the message was properly
uploaded before deleti
^
offlineimap.sgml:895: parser error : Opening and ending tag mismatch:
ulink line 895 and unparseable
<ulink
url="http://lists.complete.org/offlineimap@xxxxxxxxxxxx/";></>.
^
offlineimap.sgml:903: parser error : Entity 'OfflineIMAP' not defined
&OfflineIMAP; homepage.
^
offlineimap.sgml:914: parser error : Entity 'OfflineIMAP' not defined
If you are upgrading from a version of &OfflineIMAP; prior to
^
offlineimap.sgml:916: parser error : Entity 'OfflineIMAP' not defined
&OfflineIMAP; starts up (relating to ConfigParser or
^
offlineimap.sgml:923: parser error : Entity 'OfflineIMAP' not defined
First thing you need to do is stop any running &OfflineIMAP;
^
offlineimap.sgml:935: parser error : Entity 'OfflineIMAP' not defined
&OfflineIMAP;'s status directory area has also changed.
^
offlineimap.sgml:940: parser error : Entity 'OfflineIMAP' not defined
When you start up &OfflineIMAP; 4.0, it will re-download all
^
offlineimap.sgml:949: parser error : Entity 'copy' not defined
<para>OfflineIMAP, and this manual, are Copyright © 2002 -
2006 John
^
offlineimap.sgml:972: parser error : Entity 'OfflineIMAP' not defined
<filename>COPYRIGHT</filename> in the &OfflineIMAP;
^
offlineimap.sgml:979: parser error : Entity 'OfflineIMAP' not defined
<para>&OfflineIMAP;, its libraries, documentation, and all
included files,
^
offlineimap.sgml:985: parser error : Entity 'OfflineIMAP' not defined
&OfflineIMAP; may be downloaded, and information found, from its
^
offlineimap.sgml:1002: parser error : Entity 'OfflineIMAP' not defined
lder</> path names.
^
offlineimap.sgml:1008: parser error : Entity 'OfflineIMAP' not defined
Development on &OfflineIMAP; began on June 18, 2002. Version
^
offlineimap.sgml:1022: parser error : Entity 'OfflineIMAP' not defined
&OfflineIMAP;. This manual also was introduced with 3.0.0,
^
offlineimap.sgml:1027: parser error : Entity 'OfflineIMAP' not defined
GUI interface. &OfflineIMAP; entered maintenance mode for
^
offlineimap.sgml:1043: parser error : Opening and ending tag mismatch:
refsect2 line 241 and refentry
</refentry>
^
offlineimap.sgml:1044: parser error : Opening and ending tag mismatch:
refsect1 line 181 and reference
</reference>
^
offlineimap.sgml:1052: parser error : Premature end of data in tag
refentry line 9
^
offlineimap.sgml:1052: parser error : Premature end of data in tag
reference line 6
^
unable to parse offlineimap.sgml
Unable to recognise encoding of this document at
/usr/share/perl5/vendor_perl/XML/SAX/PurePerl/EncodingDetect.pm line 100.
Document requires an element [Ln: 1, Col: 0]
^
What am I doing wrong? Wouldn't be possible to include in the source
tarball the already converted man page?
Thanks in advance for any help
Giorgio Lando
- how to convert man pages?,
Giorgio Lando <=
|
|
