>> Javen Warner wrote:
>>
>> Hi Everyone :-)
>>
>> There seems to be a serious lack of documentation.
>>
>> I know that freemware is still only in development...
>>
>> But the documentation i have is sh*t, so, is there anywhere i can get some
>> definitive information about how to set-up freemware.
Ok, disregarding the rest of this message about the current state of the
docs, there aren't any docs outlining how to set it up, AFAIK. Well, apart
from whatever's wrapped up in the tarball, and the code itself. I also
believe that the java front-end has some brief documentation with it.
Obviously, if you'd like to cobble something together as a basic
how-to-get-started document in DocBook, that would be much appreciated. :-)
>> If not, Why???
>
>
>There were some people who volunteered to start some docs
>for plex86. Not sure what the progress is.
I'm just going to drop the makefiles and directory structure on the ftp
site sometime this week, as well as a half-completed DocBook version of
your paper..it's large enough to be unwieldy, so I welcome anyone else who
wants to take a stab at it (mostly the tables are not complete). I'll also
drop in a list of tools that you need to build the docs, and where to get
them. Presumably this will all get easier once we do that.. :-)
>The choice for docs format was DocBook, since that's
>what the LDP is doing. I'm not sure if using SGML (as
>I had recommended) is a problem, since I don't know
>how supported the SGML tools are anymore. Anyone
>want to comment on using XML vs SGML? I don't
>really care which we use, since you can do DocBook
>in either.
At this point I'm still using SGML, since that where the latest 'stable'
version of DocBook is. 4.0 is sitting in XML rather nicely, but is still
in beta according to Oasis, so I thought I'd wait. The SGML tools still
work at this point, so I don't worry about that, especially since it's not
likely that XML will completely replace SGML for quite some time. There
are more XML-aware editors out there than for SGML, but you still have
emacs/Lyx/Framemaker, or, if you're like me, a normal text editor. The
only tools that we *really* require are the ones for building other target
formats from the SGML (the sgmltools package...which was probably what you
were talking about anyhow), and if the day comes where they're not
supported anymore...well, use the source, Luke. :-)
--
Nick Bastin
Software Developer
OPNET Technologies
