You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by Glenn Nielsen <gl...@voyager.apg.more.net> on 2001/09/10 14:17:08 UTC
Tomcat 4 Documentation
I have a couple of suggestions for the new Tomcat 4 documentation.
1. In addition to the browser window title bar, put the name of the
documentation being viewed just below the Tomcat page header.
2. Provide a way to display a printer friendly version of the documents
so they can be viewed/printed without the left navigation menu.
Regards,
Glenn
----------------------------------------------------------------------
Glenn Nielsen glenn@more.net | /* Spelin donut madder |
MOREnet System Programming | * if iz ina coment. |
Missouri Research and Education Network | */ |
----------------------------------------------------------------------
Re: Tomcat 4 Documentation
Posted by "TAKAHASHI Hideo(BSD-M1G)" <hi...@bisd.hitachi.co.jp>.
OK, I checked the nightly build.
I have to say sorry because I found out another table tag that needs to
be fixed the same way. The one inside subsection also needs to be
changed to avoid clipping. I think I lost track of what I modified in
my first report. I should have used diff or something rather than rely
on my memory. This time I checked with windiff.
regards,
Hideo
"Craig R. McClanahan" wrote:
>
> That is quite odd ... the config/server.xml page works correctly for me on
> NS4.7 (Linux and Windows 98) and IE5.5 (Windows 98) at 1024x768, as well
> as narrower sizes when I adjust it manually.
>
> I just committed a change to remove the width="100%" entry for attributes
> list tables. Could you take a look at the output in nightly build
> 20010913 (tonight) and see if this corrects the problem for you?
>
> Craig
>
> On Thu, 13 Sep 2001, TAKAHASHI Hideo(BSD-M1G) wrote:
>
> > Date: Thu, 13 Sep 2001 11:48:09 +0900
> > From: "TAKAHASHI Hideo(BSD-M1G)" <hi...@bisd.hitachi.co.jp>
> > Reply-To: tomcat-dev@jakarta.apache.org
> > To: tomcat-dev@jakarta.apache.org
> > Subject: Re: Tomcat 4 Documentation
> >
> > Hi.
> >
> > I have had the same problem. It happens on pages for example
> > config/server.html. It happens on NS4.7,NS6.1,IE5.5 alike.
> > BTW My screen size is 1280x1024.
> >
> > I examined the generated html and the stylesheet, and tracked down which
> > of the width attributes are the key to this problem.
> >
> > By taking away the width attribute from the innermost table tag, or
> > changing 100% to something like 80% or 90% works for my case. I took it
> > off from the table tag found inside <xsl:template match="attributes"> in
> > web-apps/tomcat-docs/tomcat-docs.xsl
> >
> > Specifying no width will cause tables with shorter content to appear in
> > smaller width, which might be not very pretty. Specifying an absolute
> > value like 80 or 90 percent will work only with a certain browser window
> > size. When I resize the browser to be narrower, contents will be
> > clipped again.
> >
> > Hideo.
> >
> > "Craig R. McClanahan" wrote:
> > >
> > > > > One other thing I noticed with the docs. On my system at home, Netscape
> > > > 4.7
> > > > > on FreeBSD the right margin for the docs is cut off and not viewable.
> > > >
> > > > I noticed the same thing with IE on Windows. Aside from that, I like the way
> > > > the new docs look.
> > > >
> > >
> > > The only time I've had this happen to me is when there is a <source> box
> > > that is wider than my current browser window width. Are either of you
> > > seeing this in other circumstances? It would also be helpful to know
> > > which particular pages do this (in most cases, wide source code examples
> > > can be reformatted), or if it is all of them.
> > >
> > > FWIW, the outermost <table> tag that is generated is
> > >
> > > <table ... width="100%" ...>
> > >
> > > just like the Anakia templates for jakarta-site2, so it is reacting the
> > > same way to the same sorts of input.
> > >
> > > > Jon
> > > >
> > >
> > > Craig
> >
> > --
> > Hideo Takahashi
> > Business Solutions Division, Hitachi Ltd.
> > http://www.hitachi.co.jp/Div/bisd
> >
--
Hideo Takahashi
Business Solutions Division, Hitachi Ltd.
http://www.hitachi.co.jp/Div/bisd
Re: Tomcat 4 Documentation
Posted by "Craig R. McClanahan" <cr...@apache.org>.
That is quite odd ... the config/server.xml page works correctly for me on
NS4.7 (Linux and Windows 98) and IE5.5 (Windows 98) at 1024x768, as well
as narrower sizes when I adjust it manually.
I just committed a change to remove the width="100%" entry for attributes
list tables. Could you take a look at the output in nightly build
20010913 (tonight) and see if this corrects the problem for you?
Craig
On Thu, 13 Sep 2001, TAKAHASHI Hideo(BSD-M1G) wrote:
> Date: Thu, 13 Sep 2001 11:48:09 +0900
> From: "TAKAHASHI Hideo(BSD-M1G)" <hi...@bisd.hitachi.co.jp>
> Reply-To: tomcat-dev@jakarta.apache.org
> To: tomcat-dev@jakarta.apache.org
> Subject: Re: Tomcat 4 Documentation
>
> Hi.
>
> I have had the same problem. It happens on pages for example
> config/server.html. It happens on NS4.7,NS6.1,IE5.5 alike.
> BTW My screen size is 1280x1024.
>
> I examined the generated html and the stylesheet, and tracked down which
> of the width attributes are the key to this problem.
>
> By taking away the width attribute from the innermost table tag, or
> changing 100% to something like 80% or 90% works for my case. I took it
> off from the table tag found inside <xsl:template match="attributes"> in
> web-apps/tomcat-docs/tomcat-docs.xsl
>
> Specifying no width will cause tables with shorter content to appear in
> smaller width, which might be not very pretty. Specifying an absolute
> value like 80 or 90 percent will work only with a certain browser window
> size. When I resize the browser to be narrower, contents will be
> clipped again.
>
> Hideo.
>
> "Craig R. McClanahan" wrote:
> >
> > > > One other thing I noticed with the docs. On my system at home, Netscape
> > > 4.7
> > > > on FreeBSD the right margin for the docs is cut off and not viewable.
> > >
> > > I noticed the same thing with IE on Windows. Aside from that, I like the way
> > > the new docs look.
> > >
> >
> > The only time I've had this happen to me is when there is a <source> box
> > that is wider than my current browser window width. Are either of you
> > seeing this in other circumstances? It would also be helpful to know
> > which particular pages do this (in most cases, wide source code examples
> > can be reformatted), or if it is all of them.
> >
> > FWIW, the outermost <table> tag that is generated is
> >
> > <table ... width="100%" ...>
> >
> > just like the Anakia templates for jakarta-site2, so it is reacting the
> > same way to the same sorts of input.
> >
> > > Jon
> > >
> >
> > Craig
>
> --
> Hideo Takahashi
> Business Solutions Division, Hitachi Ltd.
> http://www.hitachi.co.jp/Div/bisd
>
Re: Tomcat 4 Documentation
Posted by "TAKAHASHI Hideo(BSD-M1G)" <hi...@bisd.hitachi.co.jp>.
Hi.
I have had the same problem. It happens on pages for example
config/server.html. It happens on NS4.7,NS6.1,IE5.5 alike.
BTW My screen size is 1280x1024.
I examined the generated html and the stylesheet, and tracked down which
of the width attributes are the key to this problem.
By taking away the width attribute from the innermost table tag, or
changing 100% to something like 80% or 90% works for my case. I took it
off from the table tag found inside <xsl:template match="attributes"> in
web-apps/tomcat-docs/tomcat-docs.xsl
Specifying no width will cause tables with shorter content to appear in
smaller width, which might be not very pretty. Specifying an absolute
value like 80 or 90 percent will work only with a certain browser window
size. When I resize the browser to be narrower, contents will be
clipped again.
Hideo.
"Craig R. McClanahan" wrote:
>
> > > One other thing I noticed with the docs. On my system at home, Netscape
> > 4.7
> > > on FreeBSD the right margin for the docs is cut off and not viewable.
> >
> > I noticed the same thing with IE on Windows. Aside from that, I like the way
> > the new docs look.
> >
>
> The only time I've had this happen to me is when there is a <source> box
> that is wider than my current browser window width. Are either of you
> seeing this in other circumstances? It would also be helpful to know
> which particular pages do this (in most cases, wide source code examples
> can be reformatted), or if it is all of them.
>
> FWIW, the outermost <table> tag that is generated is
>
> <table ... width="100%" ...>
>
> just like the Anakia templates for jakarta-site2, so it is reacting the
> same way to the same sorts of input.
>
> > Jon
> >
>
> Craig
--
Hideo Takahashi
Business Solutions Division, Hitachi Ltd.
http://www.hitachi.co.jp/Div/bisd
Re: Tomcat 4 Documentation
Posted by "Craig R. McClanahan" <cr...@apache.org>.
On Wed, 12 Sep 2001, Jonathan Eric Miller wrote:
> Date: Wed, 12 Sep 2001 20:31:01 -0500
> From: Jonathan Eric Miller <je...@uchicago.edu>
> Reply-To: tomcat-dev@jakarta.apache.org
> To: tomcat-dev@jakarta.apache.org
> Subject: Re: Tomcat 4 Documentation
>
>
> ----- Original Message -----
> From: "Glenn Nielsen" <gl...@voyager.apg.more.net>
> To: <to...@jakarta.apache.org>
> Sent: Wednesday, September 12, 2001 7:30 PM
> Subject: Re: Tomcat 4 Documentation
>
>
> > One other thing I noticed with the docs. On my system at home, Netscape
> 4.7
> > on FreeBSD the right margin for the docs is cut off and not viewable.
>
> I noticed the same thing with IE on Windows. Aside from that, I like the way
> the new docs look.
>
The only time I've had this happen to me is when there is a <source> box
that is wider than my current browser window width. Are either of you
seeing this in other circumstances? It would also be helpful to know
which particular pages do this (in most cases, wide source code examples
can be reformatted), or if it is all of them.
FWIW, the outermost <table> tag that is generated is
<table ... width="100%" ...>
just like the Anakia templates for jakarta-site2, so it is reacting the
same way to the same sorts of input.
> Jon
>
Craig
Re: Tomcat 4 Documentation
Posted by Jonathan Eric Miller <je...@uchicago.edu>.
----- Original Message -----
From: "Glenn Nielsen" <gl...@voyager.apg.more.net>
To: <to...@jakarta.apache.org>
Sent: Wednesday, September 12, 2001 7:30 PM
Subject: Re: Tomcat 4 Documentation
> One other thing I noticed with the docs. On my system at home, Netscape
4.7
> on FreeBSD the right margin for the docs is cut off and not viewable.
I noticed the same thing with IE on Windows. Aside from that, I like the way
the new docs look.
Jon
Re: Tomcat 4 Documentation
Posted by Glenn Nielsen <gl...@voyager.apg.more.net>.
"Craig R. McClanahan" wrote:
>
> On Mon, 10 Sep 2001, Glenn Nielsen wrote:
>
> > Date: Mon, 10 Sep 2001 07:17:08 -0500
> > From: Glenn Nielsen <gl...@voyager.apg.more.net>
> > Reply-To: tomcat-dev@jakarta.apache.org
> > To: Tomcat-dev@jakarta.apache.org
> > Subject: Tomcat 4 Documentation
> >
> > I have a couple of suggestions for the new Tomcat 4 documentation.
> >
> > 1. In addition to the browser window title bar, put the name of the
> > documentation being viewed just below the Tomcat page header.
> >
>
> This one was easy (stylesheets are your friend ;-).
>
> > 2. Provide a way to display a printer friendly version of the documents
> > so they can be viewed/printed without the left navigation menu.
> >
>
> I'm going to have to do a little thinking about how to do this gracefully.
> It's a good idea, but may or may not get done in time for this release
> (unless someone else comes up with a patch).
>
This can easily be done for documentation if it is running in Apache or
Tomcat with SSI by doing an SSI include. i.e. The default pages do a SSI
of the printer friendly version. The menu bar contains a link to the
printer friendly version so it can be viewed separately.
Of course this won't work for viewing the docs outside of a container that
supports SSI.
One other thing I noticed with the docs. On my system at home, Netscape 4.7
on FreeBSD the right margin for the docs is cut off and not viewable.
Glenn
----------------------------------------------------------------------
Glenn Nielsen glenn@more.net | /* Spelin donut madder |
MOREnet System Programming | * if iz ina coment. |
Missouri Research and Education Network | */ |
----------------------------------------------------------------------
Re: Tomcat 4 Documentation
Posted by "Craig R. McClanahan" <cr...@apache.org>.
On Mon, 10 Sep 2001, Glenn Nielsen wrote:
> Date: Mon, 10 Sep 2001 07:17:08 -0500
> From: Glenn Nielsen <gl...@voyager.apg.more.net>
> Reply-To: tomcat-dev@jakarta.apache.org
> To: Tomcat-dev@jakarta.apache.org
> Subject: Tomcat 4 Documentation
>
> I have a couple of suggestions for the new Tomcat 4 documentation.
>
> 1. In addition to the browser window title bar, put the name of the
> documentation being viewed just below the Tomcat page header.
>
This one was easy (stylesheets are your friend ;-).
> 2. Provide a way to display a printer friendly version of the documents
> so they can be viewed/printed without the left navigation menu.
>
I'm going to have to do a little thinking about how to do this gracefully.
It's a good idea, but may or may not get done in time for this release
(unless someone else comes up with a patch).
> Regards,
>
> Glenn
>
Craig