Re: [opensuse] How can I write man pages? Linuxdoc/Docbook anyone? Report on manedit -----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1



The Saturday 2008-02-09 at 17:56 +0100, Jos van Kan wrote:

.

> But wait, you're almost there! The only thing you need is a sed script to
> convert the utf-8 symbols to groff_char(7) gibberish, right?

Yes, right. But from latin1: manedit does not support utf.


> Something like
> utf2groff
>
> #!/bin/sed -f
> #
> # Convert utf 8 to groff_char(7)
>
> s/Ã©/\\\\('e/g
> s/Ã¨/\\\\(`e/g
> .
> .
> .
> # etc

Doesn't seem complicated... I've never done a sed script. I was thinking 
of doing it in pascal, just for the laugh of it, but sed would 
maintainable by others if needed.


> You'd have to throw that script together only once and then you can write,
> proofread and spell check to your heart's content and when it's ok convert it to
> gibberish.

Yes...

I could work on the "file.in" file, and the Makefile would handle whatever 
it currently does, plus the conversion, producing the file.1


> Maybe it even exists already. :-)

It should. But it also should exist a man/troff editor for dummies: it 
doesn't even require graphics, it could be done in a terminal. It is a 
vetust format, a reliq of times well past, but here it is, alive and 
kicking. Specially that, kicking me.



I have seen a procedure to generate troff out of opendocument format (in 
the Heirloom Project). I haven't tested it, but I wonder. If that works, 
it would make things like spell checking much easier.

- -- 
Cheers,
        Carlos E. R.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.4-svn0 (GNU/Linux)

iD8DBQFHrfaatTMYHG2NR9URAn7IAJ9etREQShv5DWVQ0G12pOVIr4KnNgCfXuqg
nU+A25z5QFZZcC+mGHNRj7o=
=WYzY
-----END PGP SIGNATURE-----