]> git.tdb.fi Git - ext/subsurface.git/commit
First try at converting user-manual to AsciiDoc
authorLinus Torvalds <torvalds@linux-foundation.org>
Sun, 1 Jan 2012 23:12:28 +0000 (15:12 -0800)
committerLinus Torvalds <torvalds@linux-foundation.org>
Sun, 1 Jan 2012 23:12:28 +0000 (15:12 -0800)
commit1a83bf43b688dff5fa65afb751e7fdb65026e583
tree7b227079e4c34ad56fde89166db115cbae6c8bfb
parent1d51c7772996705fb69b2b3433cd94af3543583d
First try at converting user-manual to AsciiDoc

You can do "make doc" in the main directory to create the html version,
and if you want to play around with it, do "make show" in the
Documentation subdirectory to start firefox on the end result.

It's by no means perfect, but it gives somewhat reasonable results, and
this is enough initial work for people to play around with, I think.

NOTE! You need "asciidoc" installed to do this: it's a python program,
so it should be pretty easy even on non-Linux platforms.  And on Linux,
most distributions package it, so you just have to do something like

yum install asciidoc

to get it (replace with apt-get/zypper/whatever).

Asciidoc can generate other output too (man-pages, LaTeX, etc), maybe
people want to play with that part too.

Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
Documentation/Makefile [new file with mode: 0644]
Documentation/user-manual.txt
Makefile