You are viewing a plain text version of this content. The canonical link for it is here.
Posted to websh-dev@tcl.apache.org by Ronnie Brunner <ro...@netcetera.ch> on 2002/03/07 12:03:05 UTC
"making" documentation
A changed some documentation in quickref.xml, but the makefile doesn't
work to create the html and txt versions.
what's the status of the documentation issues? What formats will we
support by default? What are the prerequisites for being able to
"make" the doc files?
Ronnie
------------------------------------------------------------------------
Ronnie Brunner ronnie.brunner@netcetera.ch
Netcetera AG, 8040 Zuerich phone +41 1 247 79 79 Fax: +41 1 247 70 75
---------------------------------------------------------------------
To unsubscribe, e-mail: websh-dev-unsubscribe@tcl.apache.org
For additional commands, e-mail: websh-dev-help@tcl.apache.org
Re: "making" documentation
Posted by "David N. Welton" <da...@dedasys.com>.
Ronnie Brunner <ro...@netcetera.ch> writes:
> ok. let's just make sure, the installation rule of the makefile is
> in sync with what we provide.
It might be a good idea to eliminate the Makefile. I added it for now
for our convenience, and so that people would have an idea of how to
build the documentation.
I don't have a good idea as to how to make it work across different
computers which may keep the files in different places. As far as
installing it... hrm. I will have to think about that some. Man
pages are pretty standard, but where would we want to put something
like quickref.html?
--
David N. Welton
Consulting: http://www.dedasys.com/
Personal: http://www.dedasys.com/davidw/
Free Software: http://www.dedasys.com/freesoftware/
Apache Tcl: http://tcl.apache.org/
---------------------------------------------------------------------
To unsubscribe, e-mail: websh-dev-unsubscribe@tcl.apache.org
For additional commands, e-mail: websh-dev-help@tcl.apache.org
Re: "making" documentation
Posted by Ronnie Brunner <ro...@netcetera.ch>.
ok. let's just make sure, the installation rule of the makefile is in
sync with what we provide.
> > A changed some documentation in quickref.xml, but the makefile
> > doesn't work to create the html and txt versions.
>
> The HTML version will be the initial target.
>
> > what's the status of the documentation issues?
>
> Working on it.
>
> > What formats will we support by default?
>
> HTML. From that we could also get text, if the output that we get
> from the XML isn't suitable. If we have time, and it looks doable,
> man pages will also be attempted.
>
> > What are the prerequisites for being able to "make" the doc files?
>
> I put the makefile in there just to help myself out... It will be a
> maintainer only thing (meaning we should ship even the sources with
> the HTML). The problem is that you have to point to the correct
> location of this:
>
> /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/html/docbook.xsl
>
------------------------------------------------------------------------
Ronnie Brunner ronnie.brunner@netcetera.ch
Netcetera AG, 8040 Zuerich phone +41 1 247 79 79 Fax: +41 1 247 70 75
---------------------------------------------------------------------
To unsubscribe, e-mail: websh-dev-unsubscribe@tcl.apache.org
For additional commands, e-mail: websh-dev-help@tcl.apache.org
Re: "making" documentation
Posted by "David N. Welton" <da...@dedasys.com>.
Ronnie Brunner <ro...@netcetera.ch> writes:
> A changed some documentation in quickref.xml, but the makefile
> doesn't work to create the html and txt versions.
The HTML version will be the initial target.
> what's the status of the documentation issues?
Working on it.
> What formats will we support by default?
HTML. From that we could also get text, if the output that we get
from the XML isn't suitable. If we have time, and it looks doable,
man pages will also be attempted.
> What are the prerequisites for being able to "make" the doc files?
I put the makefile in there just to help myself out... It will be a
maintainer only thing (meaning we should ship even the sources with
the HTML). The problem is that you have to point to the correct
location of this:
/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/html/docbook.xsl
--
David N. Welton
Consulting: http://www.dedasys.com/
Personal: http://www.dedasys.com/davidw/
Free Software: http://www.dedasys.com/freesoftware/
Apache Tcl: http://tcl.apache.org/
---------------------------------------------------------------------
To unsubscribe, e-mail: websh-dev-unsubscribe@tcl.apache.org
For additional commands, e-mail: websh-dev-help@tcl.apache.org