patch, 2 partsFix the building of gitman.info document

In these days Info documents are probably only used by Emacs users. I'm one, so I wanted to fix the building of Git Info documents. And it's even possible - to certain extent.

My real opinion is that the document conversion chain .txt - .xml - .texi - .info. just can't work without a miracle. These patches certainly don't do a miracle but they allow building an usable Info version of the user manual and the man pages. As usual, there are problems with markup conversions. For example, two dashes (--) in a .texi file turn into one Ascii dash (-), so there are options like "-interactive" and "-stat" in the Info documents. I wouldn't advertise these documents very loudly to the public.

(My real real real opinion is that the GNU people should drop the Info system and start using html instead. Html probably isn't a simple drop-in replacement but at least it's a relevant format in 2008-2009.)

Teemu Likonen (2):
  Fix the building of user-manual.texi and gitman.texi documents
  Fix the building of gitman.info document

 Documentation/Makefile      |    9 +++++----
 Documentation/cat-texi.perl |    8 ++++++--
 2 files changed, 11 insertions(+), 6 deletions(-)

Previously "docbook2x-texi" failed to generate user-manual.texi and gitman.texi files from .xml input files because "iconv" stopped at "illegal input sequence" error. This was due to some UTF-8 octets in the input .xml files. This patch adds option --encoding=UTF-8 for "docbook2x-texi" to allow the building of .texi files complete.

Signed-off-by: Teemu Likonen <tlikonen@iki.fi>
---
 Documentation/Makefile |    7 ++++---
 1 files changed, 4 insertions(+), 3 deletions(-)

"makeinfo" failed to generate gitman.info from gitman.texi input file because the combined manual page file contains several nodes with the same name (DESCRIPTION, OPTIONS, SEE ALSO etc.). An Info document should contain unique node names.

This patch creates a simple (read: ugly) work-around by suppressing the validation of the final Info file. Jumping to nodes in the Info document still works but they are not very useful. Common man-page headings like DESCRIPTION and OPTIONS appear in the Info node list and they point to the man page where they appear first (that is git-add currently).

Also, this patch adds directory-entry information for Info document to make the document appear in the top-level Info directory.

Signed-off-by: Teemu Likonen <tlikonen@iki.fi>
---
 Documentation/Makefile      |    2 +-
 Documentation/cat-texi.perl |    8 ++++++--
 2 files changed, 7 insertions(+), 3 deletions(-)

I do not build nor use info myself these days, so I'll apply the patches but when somebody else screams I'll let you and that somebody else work on improvements.

Thanks.