2014-06-10 18:25 GMT+04:00 Christopher Schultz <ch...@christopherschultz.net>: > All, > > I noticed a series of typos on the connectors docs and I was going to > fix them. Before noticing that, as usual, .xml -> .html, I saw that > there are two copies of many parts of the site: "regular" and "printer". > For example: > > ./tomcat-site/docs/connectors-doc/generic_howto/printer/workers.html > ./tomcat-site/docs/connectors-doc/generic_howto/workers.html > ./tomcat-site/docs/connectors-doc/reference/printer/workers.html > ./tomcat-site/docs/connectors-doc/reference/workers.html > > I checked, and the only difference appears to be that the "regular" > pages have a link to the "printable" pages, their links (due to nested > directories) all have an additional ".." in them, and of course the > "left navigation bar" is missing. > > Is there a reason not to do this with CSS where the @media=print just > hides the left bar? I think we'd have a slightly simpler docs/build, > fewer pages and links, etc. > > Any objections to me removing those extra pages and using CSS instead?
Just a legacy. See https://svn.apache.org/r601180 https://svn.apache.org/r717913 https://svn.apache.org/r941413 Connectors are released rather rarely, so just nobody worked on that. A caveat may be that you have to update build.xml as well and make sure that a src buindles build successfully. Both tomcat-connectors-1.2.40-src.zip and tomcat-connectors-1.2.40-src.tar.gz contain "docs" directory with generated documentation in them. The binary bundles do not have documentation in them, just README, LICENSE, NOTICE and a binary (e.g. mod_jk.so). So those are not affected. > We'd want to set up permanent redirects from the printer/* URLs to their > replacements, and I don't know how to do that from the docs themselves > unless we actually code META REFRESH which seems silly when the web > server can handle that for us. I'd need a bit of help from the infra > team for that, I think. Redirection can be done with a ".htaccess" file, like here: https://svn.apache.org/viewvc/tomcat/site/trunk/docs/faq/ Best regards, Konstantin Kolinko --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org
