Re: How out of date is misc/rewriteguide.xml?
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Another general observation, while on the topic of the rewrite guide. Docs for things which are hard should not repeatedly say that it is trivial. It makes people feel really stupid. I just removed three trivials, and that was all in one paragraph. :-) - -- :wq -BEGIN PGP SIGNATURE- Version: GnuPG v1.2.6 (GNU/Linux) Comment: Using GnuPG with Thunderbird - http://enigmail.mozdev.org iD8DBQFB0dzPXP03+sx4yJMRAqqIAJ0TAdGYTKHB7O+9z5XfNUBA9df/2gCcD+Jm IS4ptWOwjjld5lBlTB7U0hk= =BL/6 -END PGP SIGNATURE- - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
How out of date is misc/rewriteguide.xml?
I started translating some stuff under misc and I noticed it's way out of date. For example, there's Moved DocumentRoot example in http://httpd.apache.org/docs-2.1/misc/rewriteguide.html.en#ToC2 The example configuration is RewriteEngine on RewriteRule ^/$ /e/www/ [R] and it even goes to say it cannot be done by mod_alias because all mod_alias con do is prefix matching. But mod_alias can do more than mere prefix matching and even with my limited mod_rewrite and mod_alias knowledge, I know it is equivalent to RedirectMatch ^/$ /e/www/ After glancing through the whole document, I'm ++1 to Rich's idea to write our rewrite cookbook (actually, I prefer more general url mapping cookbook. mod_alias is powerful enough unless you really need to use black magic). In the meantime, I'm tempted to rip things that can also be handled by mod_alias off of rewriteguide and use it as seeds to populate urlmappingguide or whatever the new name of that document. I'm not very comfortable that we are knowingly recommending the use of mod_rewrite where mod_alias is sufficient. Opinions? I also want to clean up the rewriteguide docs further at later time, but I want to start small and finish one thing at a time. -- Yoshiki Hayashi - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: How out of date is misc/rewriteguide.xml?
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Yoshiki Hayashi wrote: | I started translating some stuff under misc and I noticed | it's way out of date. For example, there's Moved | DocumentRoot example in | http://httpd.apache.org/docs-2.1/misc/rewriteguide.html.en#ToC2 | | The example configuration is | | RewriteEngine on | RewriteRule ^/$ /e/www/ [R] | | and it even goes to say it cannot be done by mod_alias | because all mod_alias con do is prefix matching. But | mod_alias can do more than mere prefix matching and even | with my limited mod_rewrite and mod_alias knowledge, I know | it is equivalent to | | RedirectMatch ^/$ /e/www/ | | After glancing through the whole document, I'm ++1 to Rich's | idea to write our rewrite cookbook (actually, I prefer more | general url mapping cookbook. mod_alias is powerful enough | unless you really need to use black magic). | | In the meantime, I'm tempted to rip things that can also be | handled by mod_alias off of rewriteguide and use it as seeds | to populate urlmappingguide or whatever the new name of that | document. I'm not very comfortable that we are knowingly | recommending the use of mod_rewrite where mod_alias is | sufficient. Opinions? Well, I'm obviously in favor of this. It's one of those things that has been on the we should really do this list for a while. What is holding it back is, I think, that it's such a big topic. I started my wiki (rewrite.drbacchus.com) as an attempt to categorize some of the things that I thought the doc should talk about. But, you'll notice, the beginner section is completely empty. Also, almost all of the stuff in the existing rewrite guide is really good stuff. There are a few things which are outdated and should go away. And a few things are so complicated that most people just skim past them on their way to the things that they understand. So reorganization is at least as important as new content. Perhaps a conversation of exactly what we want to do would be useful, and then we can have a little division of labor and actually get it done before yet another year passes on this conversation. - -- CooperMcGregor, Inc. Apache and mod_perl training and support http://www.coopermcgregor.com/ -BEGIN PGP SIGNATURE- Version: GnuPG v1.0.7 (GNU/Linux) Comment: Using GnuPG with Thunderbird - http://enigmail.mozdev.org iD8DBQFByWOCXP03+sx4yJMRArd8AJ4wOyg1kmy/pKG7x95lIeupgkwy9gCfZQzG ErG0fHHUBPOpuQa0qA5dFiA= =b6Jj -END PGP SIGNATURE- - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: How out of date is misc/rewriteguide.xml?
On Wed, Dec 22, 2004 at 07:07:30AM -0500, Rich Bowen wrote: Well, I'm obviously in favor of this. It's one of those things that has been on the we should really do this list for a while. What is holding it back is, I think, that it's such a big topic. I started my wiki (rewrite.drbacchus.com) as an attempt to categorize some of the things that I thought the doc should talk about. But, you'll notice, the beginner section is completely empty. We've been talking about this as a topic for the hackathon for the last couple of years. I seem to recall that one of the things that keep us from doing this (other than being insanely busy preparing for a all the presentations) is that we never found a good way to structure the rewrite docs/guide. Also, almost all of the stuff in the existing rewrite guide is really good stuff. There are a few things which are outdated and should go away. And a few things are so complicated that most people just skim past them on their way to the things that they understand. So reorganization is at least as important as new content. Agreed. I think it might be the best idea to split the doc into a short getting started tutorial and a howto document (possibly a simple and an advanced howto doc). Perhaps a conversation of exactly what we want to do would be useful, and then we can have a little division of labor and actually get it done before yet another year passes on this conversation. +1 - I have a few cycles to spend on this in the next couple of months and I have some potentially useful content from my apachecon talks. vh Mads Toftum -- `Darn it, who spiked my coffee with water?!' - lwall - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
