Suggestion: add revision number to docs
Two weeks ago I started translating the next file. But I had to break my work due to very less spare time. Today, I want to go on with it while I'm wondering, if the original file has been changed since then, or not. Because I'm doing the translation with both files - original and ongoing translation - side by side. And I'm opening both files from my checkout directory. So when opening them after a break, I can't realized, if the original has been changed. Sure, i could check the commit messages or look at cvs. But it would be much easier for me, and maybe for other translators too, to have the revision number inside the xml file. This could be done by writing $Revision$ into the file. The CVS will replace it to $Revision: x.y $, where x.y is the revision number. As long as this string exists, revision number will automatically be updated. I would suggest a comment within each xml file, or an attribute, if we want to overtake this number into the html conversions. If you agree to use this, I would do the neccessary change on all xml files with a small script and commit them... Kess - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: Suggestion: add revision number to docs
On Sun, Sep 15, 2002 at 01:28:41AM +0200, Astrid Keßler wrote: This could be done by writing $Revision$ into the file. The CVS will replace it to $Revision: x.y $, where x.y is the revision number. As long as this string exists, revision number will automatically be updated. I think this is a bad idea. -0. There are much better ways to get the revision of the file - such as cvs stat, watching commit logs, etc. - without polluting the original file. Commit early and often if you are worried about getting out-of-sync. -- justin - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Review: AddOutputFilterByType (was: no doc for MaxMemFree or AddOutputFilterByType)
* Jeff Trawick wrote: What about AddOutputFilterByType? Is that working properly now? It works at least for me (win32, 2.0.40 tested). I've attached a patch for core.xml that should match the current HEAD (of core.c). Please review and feel free to correct the English if neccessary ;-) The patch was reviewed and discussed before with Kess. nd -- die (eval q-qq:Just Another Perl Hacker :-) # André Malo, http://www.perlig.de/ # Index: core.xml === RCS file: /home/cvs/httpd-2.0/docs/manual/mod/core.xml,v retrieving revision 1.27 diff -u -r1.27 core.xml --- core.xml5 Sep 2002 02:34:38 - 1.27 +++ core.xml14 Sep 2002 23:52:06 - @@ -143,6 +143,70 @@ /directivesynopsis directivesynopsis +nameAddOutputFilterByType/name +descriptionassigns an output filter to a particular MIME-type/description +syntaxAddOutputFilterByType emfilter/em emMIME-type/em +[emMIME-type/em] .../syntax +contextlistcontextserver config/context +contextvirtual host/contextcontextdirectory/context +context.htaccess/context/contextlist +overrideFileInfo/override +compatibilityAvailable in Apache 2.0.33 and later/compatibility + +usage +pThis directive activates a particular output a +href=../filter.htmlfilter/a for a request depending on the +response MIME-type./p + +pThe following example uses the DEFLATE filter, which is provided by +modulemod_deflate/module. It will compress all output (either static +or dynamic) which is labeled as codetext/html/code or +codetext/plain/code before it is sent to the client./p + +example + AddOutputFilterByType DEFLATE text/html text/plain +/example + +pIf you want the content to be processed by more than one filter, you +have to use one directiveAddOutputFilterByType/directive +directive for each of them. Filters of the same type are processed in +strongreversed/strong order they appear in your configuration, +but see also a href=../sections.html#merginin which order +configuration sections are merged/a./p + +pIf the filters are of different types, the order in which they are +applied is dependant on the type. For example, the INCLUDES filter +is typed as codeAP_FTYPE_RESOURCE/code and the DEFLATE filter as +codeAP_FTYPE_CONTENT_SET/code. Since the latter is always processed +after codeAP_FTYPE_RESOURCE/code, the DEFLATE filter will always +be processed after INCLUDES./p + +pThus the configuration below causes all script output labeled as +codetext/html/code to be processed at first by the INCLUDES filter +and then by the DEFLATE filter./p + +example +pre +lt;Location /cgi-bin/gt; + Options Includes + AddOutputFilterByType INCLUDES text/html + AddOutputFilterByType DEFLATE text/html +lt;/Locationgt; +/pre +/example +note +pstrongNote:/strong The output filters are not applied on proxy requests./p +/note +/usage + +seealsodirective module=mod_mimeAddOutputFilter/directive/seealso +seealsodirective module=coreSetOutputFilter/directive/seealso +seealsomodulemod_include/module/seealso +seealsomodulemod_deflate/module/seealso +seealsoa href=../filter.htmlThe filters documentation/a/seealso +/directivesynopsis + +directivesynopsis nameAllowOverride/name descriptionTypes of directives that are allowed in .htaccess files/description - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: Review: AddOutputFilterByType (was: no doc for MaxMemFree or AddOutputFilterByType)
On Sun, Sep 15, 2002 at 02:08:45AM +0200, André Malo wrote: +pIf you want the content to be processed by more than one filter, you +have to use one directiveAddOutputFilterByType/directive +directive for each of them. Filters of the same type are processed in +strongreversed/strong order they appear in your configuration, +but see also a href=../sections.html#merginin which order +configuration sections are merged/a./p Hmm, we should be able to support DEFLATE;INCLUDES. For example: AddOutputFilterByType DEFLATE;INCLUDES text/html Err, yeah, the code doesn't like that. I'll try to fix that up today if I get a chance. Otherwise, +1. -- justin - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
[NEW] netware.xml;perf-hp.xml
Hi! This are the first 2 platform-docs (netware, perf-hp) in xml. The other platform-docs follow at the next few days. *ww* Tim?xml version=1.0 encoding=UTF-8 ? !DOCTYPE manualpage SYSTEM ../style/manualpage.dtd ?xml-stylesheet type=text/xsl href=../style/manual.en.xsl? manualpage relativepath href=.. / titleUsing Apache With Novell NetWare/title summary pThis document explains how to install, configure and run Apache 2.0 under Novell NetWare 5.1 and above. If you find any bugs, or wish to contribute in other ways, please use our a href=http://httpd.apache.org/bug_report.html;bug reporting page./a/p pThe bug reporting page and dev-httpd mailing list are emnot/em provided to answer questions about configuration or running Apache. Before you submit a bug report or request, first consult this document, the a href=../faq/index.htmlFrequently Asked Questions/a page and the other relevant documentation topics. If you still have a question or problem, post it to the a href=news://developer-forums.novell.com/novell.devsup.webserver; novell.devsup.webserver/a newsgroup, where many Apache users are more than willing to answer new and obscure questions about using Apache on NetWare./p pMost of this document assumes that you are installing Apache from a binary distribution. If you want to compile Apache yourself (possibly to help with development, or to track down bugs), see the section on a href=#compCompiling Apache for NetWare/a below./p /summary section id=req titleRequirements/title pApache 2.0 is designed to run on NetWare 5.1 and above./p pstrongIf running on NetWare 5.1 you must install Service Pack 4 or above./strong/p pstrongIf running on NetWare 6 you must install Service Pack 1 or above./strong/p pNetWare service packs are available a href=http://support.novell.com/misc/patlst.htm#nw;here/a./p /section section id=down titleDownloading Apache for NetWare/title pInformation on the latest version of Apache can be found on the Apache web server at a href=http://www.apache.org/;http://www.apache.org//a. This will list the current release, any more recent alpha or beta-test releases, together with details of mirror web and anonymous ftp sites./p /section section id=inst titleInstalling Apache for NetWare/title pThere is no Apache install program for NetWare currently. You will need to compile apache and copy the files over to the server manually. An install program will be posted at a later date./p pFollow these steps to install Apache on NetWare from the binary download (assuming you will install to codesys:/apache2/code):/p ul liUnzip the binary download file to the root of the codeSYS:/code volume (may be installed to any volume)/li liEdit the codehttpd.conf/code file setting directive module=core ServerRoot/directive and directive module=coreServerName/directive to reflect your correct server settings/li liAdd codeSYS:/APACHE2/code to the search path. (emExample/em: codeSEARCH ADD SYS:\APACHE2/code)/li /ul pFollow these steps to install Apache on NetWare manually from your own build source (assuming you will install to codesys:/apache/code):/p ul liCreate a directory called codeApache2/code on a NetWare volume/li liCopy codeAPACHE2.NLM/code, codeAPRLIB.NLM/code, codeHTDIGEST.NLM/code, codeHTPASSWD.NLM/code to codeSYS:/APACHE2/code/li liCreate a directory under codeSYS:/APACHE2/code called codeCONF/code/li liCopy the codeHTTPD-STD.CONF/code file to the codeSYS:/APACHE2/CONF/code directory and rename to codeHTTPD.CONF/code/li liCopy the codeMIME.TYPES/code and codeMAGIC/code files to codeSYS:/APACHE2/CONF/code directory/li liCopy all files and subdirectories in code\HTTPD-2.0\DOCS\ICONS/code to codeSYS:/APACHE2/ICONS/code/li liCopy all files and subdirectories in code\HTTPD-2.0\DOCS\MANUAL/code to codeSYS:/APACHE2/MANUAL/code/li liCopy all files and subdirectories in code\HTTPD-2.0\DOCS\ERROR/code to codeSYS:/APACHE2/ERROR/code/li liCopy all files and subdirectories in code\HTTPD-2.0\DOCS\DOCROOT/code to codeSYS:/APACHE2/HTDOCS/code/li liCreate the directory codeSYS:/APACHE2/LOGS/code on the server/li liCreate the directory codeSYS:/APACHE2/CGI-BIN/code on the server/li liCreate the directory codeSYS:/APACHE2/MODULES/code and copy all nlm modules into the codemodules/code directory/li liEdit the codeHTTPD.CONF/code file searching for all code@@Value@@/code markers and replacing them with the appropriate setting/li liAdd codeSYS:/APACHE2/code to the search path. (emExample/em: codeSEARCH ADD SYS:\APACHE2/code)/li /ul pApache may be
Question on install.xml/install.html.en
The compiling and installing documentation contains at Requirements Perl 5: For some of the support scripts like apxs or dbmmanage (which are written in Perl) the Perl 5 interpreter is required (versions 5.003 and 5.004 are fine) 5.003/5.004 are very old. Current Perl Version is 5.8. So this sentence seems like never changed since it has been written. Shouldn't we change it to soumething like: For some of the support scripts like apxs or dbmmanage (which are written in Perl) the Perl 5 interpreter is required (versions 5.003 and 5.004 are sufficient) or maybe suggest a newer version? Kess - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: Question on install.xml/install.html.en
On Sun, Sep 15, 2002 at 02:53:06AM +0200, Astrid Keßler wrote: For some of the support scripts like apxs or dbmmanage (which are written in Perl) the Perl 5 interpreter is required (versions 5.003 and 5.004 are sufficient) 5.003 or newer are sufficient. -- justin - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: Review: AddOutputFilterByType
* Justin Erenkrantz wrote: AddOutputFilterByType DEFLATE;INCLUDES text/html Err, yeah, the code doesn't like that. I'll try to fix that up today if I get a chance. ok, I see the change, but two points: - AFAICS the filter ordering is still reversed (in contrast to the mod_mime definition)? - this ordering doesn't affect the DEFLATE and INCLUDES filter (because of different filter types), right?. If so, they are bad examples for the filter;filter notation in general. Perhaps this should be mentioned in the mod_mime docs resp. the filters docs, too... nd -- die (eval q-qq[Just Another Perl Hacker ] ;-) # André Malo, http://www.perlig.de/ # - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [NEW] netware.xml;perf-hp.xml
* Tim Gerundt wrote: This are the first 2 platform-docs (netware, perf-hp) in xml. Thanks! I've committed them with a few modifications (some oddities, stylistic changes). nd -- $_=q?tvc!uif)%*|#Bopuifs!A`#~tvc!Xibu)%*|qsjou#Kvtu!A`#~tvc!KBQI!)*|~ tvc!ifmm)%*|#Qfsm!A`#~tvc!jt)%*|(Ibdlfs(~ # What the hell is JAPH? ; @_=split/\s\s+#/;$_=(join''=map{chr(ord( # André Malo ; $_)-1)}split//=$_[0]).$_[1];s s.*s$_see; # http://www.perlig.de/ ; - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: Does Doc 1.3 have XML version?
On 15 Sep 2002, JHKChan wrote: When I see doc 2.0, it uses XML and is prettier. However, does doc 1.3 have XML version? If not, I will just translate in HTML, else I think XML is more convenient. Thx XML would indeed be more convenient, but, no, the 1.3 docs have never been translated to XML. -- Rich Bowen - [EMAIL PROTECTED] http://kenya.rcbowen.com/ - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
[NEW] win_compiling.xml;win_service.xml;windows.xml
Hi! Ok, this are the other platform-docs in xml. *ww* Tim?xml version=1.0 encoding=UTF-8 ? !DOCTYPE manualpage SYSTEM ../style/manualpage.dtd ?xml-stylesheet type=text/xsl href=../style/manual.en.xsl? manualpage relativepath href=.. / titleCompiling Apache for Microsoft Windows/title summary pThere are many important points before you begin compiling Apache. See a href=windows.htmlUsing Apache with Microsoft Windows/a before you begin./p /summary section id=requirements titleRequirements/title pCompiling Apache requires the following environment to be properly installed:/p ul li pDisk Space/p pMake sure you have at least 50 MB of free disk space available. After installation Apache requires approximately 10 MB of disk space, plus space for log and cache files, which can grow rapidly. The actual disk space requirements will vary considerably based on your chosen configuration and any third-party modules or libraries./p /li li pMicrosoft Visual C++ 5.0 or higher./p pApache can be built using the command line tools, or from within the Visual Studio IDE Workbench. The command line build requires the environment to reflect the codePATH/code, codeINCLUDE/code, codeLIB/code and other variables that can be configured with the codevcvars32/code batch file:/p example c:\Program Files\DevStudio\VC\Bin\vcvars32.bat /example /li li pThe Windows Platform SDK./p pVisual C++ 5.0 builds require an updated Microsoft Windows Platform SDK to enable some Apache features. For command line builds, the Platform SDK environment is prepared by the codesetenv/code batch file:/p example c:\Program Files\Platform SDK\setenv.bat /example pThe Platform SDK files distributed with Visual C++ 6.0 and later are sufficient, so users of later version may skip this requirement./p noteNote that the Windows Platform SDK update is required to enable all supported modulemod_isapi/module features. Without a recent update, Apache will issue warnings under MSVC++ 5.0 that some modulemod_isapi/module features will be disabled. Look for the update at a href=http://msdn.microsoft.com/downloads/sdks/platform/platform.asp; http://msdn.microsoft.com/downloads/sdks/platform/platform.asp/a./note /li li pThe awk utility (awk, gawk or similar)./p pTo install Apache within the build system, several files are modified using the codeawk.exe/code utility. awk was chosen since it is a very small download (compared with Perl or WSH/VB) and accomplishes the task of generating files. Brian Kernighan's a href=http://cm.bell-labs.com/cm/cs/who/bwk/; http://cm.bell-labs.com/cm/cs/who/bwk//a site has a compiled native Win32 binary, a href=http://cm.bell-labs.com/cm/cs/who/bwk/awk95.exe; http://cm.bell-labs.com/cm/cs/who/bwk/awk95.exe/a which you must save with the name codeawk.exe/code rather than codeawk95.exe/code./p noteNote that Developer Studio IDE will only find codeawk.exe/code from the Tools menu Options... Directories tab (the Projects - VC++ Directories pane in Developer Studio 7.0) listing Executable file paths. Add the path for codeawk.exe/code to this list, and your system codePATH/code environment variable, as needed./note noteAlso note that if you are using Cygwin (a href=http://www.cygwin.com/; http://www.cygwin.com//a) the awk utility is named codegawk.exe/code and that the file codeawk.exe/code is really a symlink to the codegawk.exe/code file. The Windows command shell does not recognize symlinks, and because of that building InstallBin will fail. A workaround is to delete codeawk.exe/code from the cygwin installation and rename codegawk.exe/code to codeawk.exe/code./note /li li p[Optional] OpenSSL libraries (for modulemod_ssl/module and codeab.exe/code with ssl support)/p pstrongCaution: there are significant restrictions and prohibitions on the use and distribution of strong cryptography and patented intellectual property throughout the world./strong OpenSSL includes strong cryptography controlled by both export regulations and domestic law, as well as intellectual property protected by patent, in the United States and elsewhere. Neither the Apache Software Foundation nor the OpenSSL project can provide legal advise regarding possession, use, or distribution of the code provided by the OpenSSL project. strongConsult your own legal counsel, you are responsible for your own
generating pdf (was Re: cvs commit: httpd-2.0/docs/manual/style/css manual-loose-100pc.css)
André Malo wrote: I have some problems with printing to PDF files directly when embedding fonts. I guess it has to do with the unicode arrow, which I used for links in the printer CSS... Am I alone with that problem? However, for now I would suggest a quickhack ;-): cp manual.css manual.css.bak cp manual-print.css manual.css The problem is that I would need to do that on httpd.apache.org because I'm using Acrobat web capture, and it will make some external links directly to the pages. I don't want those to point to my local checkout. Luckily, it seems that web capture is smart enough to automatically use the print stylesheet. Unluckily, it seems to be using a 14pt font size, no matter what I do. That makes the damn thing way too long. I'm still working on it. for the future: I'd say we should take a look at XSL formatting objects for creating PDF directly from XML data. What do you think about this option? Yep, that is the direction I was thinking of going eventually. Within 2-3 weeks I personally should have the time to learn more about XSL-FO, do we have any experts here? I'm just at the learning stage as well. Joshua. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]