[FreeBSD] / ports / textproc / htmlisehttp://cvsweb.freebsd.org/ports/textproc/htmlise
I've installed this but I can't find any documentation -anywhere- on how to use it. There is no man or help switch available for this. Can anybody give me some insight on what syntax it requires or a simple example on how I can use it?
I can't find good FAQ or man pages either. All I could find is : " A command line utility that formats plain text from standard input to HTML. " - the author is here - there's only link to the software. You may try to contact him, or browse the source code, thus answering your questions, though that's the harder variant 
Well I just sent off an email but during the interim, if anybody has any clue please post. Once or if I receive a response I'll certainly post it here.
The only documention I have ever seen for htmlise is the "test.txt" in the source tarball.
Top-level Heading
=================
- one-item list.
This is the *** first *** paragraph, which is just normal text with nothing special
about it whatsoever. ___ This ___ http://ex-parrot.com/~chris/ is a link to my
home page; here's a link to my ___ web log, ### WWWitter, ### ___
http://ex-parrot.com/~chris/wwwitter/
for which this code is intended.
||| http://ex-parrot.com/~chris/images/photo.jpg Photograph |||
What is ___ a question? ___ http://foo.com/
``Now is the time for all good men to come to the aid of their country''
is a quote, and in this case it's indented like a block quote.
Sub-heading
-----------
Here's another paragraph.
- this is a bulleted list
- a sub-list of the first bulleted list
- second item of that list
... which has a second paragraph
- this is the second item of the enclosing list, and the item itself
stretches over multiple lines.
foo!
1. this is a numbered list, the first item having the number
one and subsequent items having higher numbers.
2. second item
block quote in second item
third paragraph of second item.
- one-item list in second item
foo
3. third item.
another normal paragraph.
Sub-sub-heading
~~~~~~~~~~~~~~~
Here is a table of some data:
Animal Collective noun
--------- --------------------------------------
crow murder
goose On the ground In flight
------------- ---------
gaggle skein
raven - unkindness
(which is
like a - a silly name
crow)
-- were these made up by mad Victorians?
We demand an answer!
This is a paragraph indented by one tab stop.
Ditto
Two tab stops.