At 17:59 12.05.2002, Stas Bekman wrote:
Per Einar Ellefsen wrote:
At 16:18 12.05.2002, Stas Bekman wrote:
Well, I think we just do as I said there. Replace "Win32" with "Operating System specific details", put those files into that directory, and leave it at that. Right now, we're not doing anything special with the Win32 docs, and I don't think anything more is needed.
so you simply suggest to move 1.0/win32 to 1.0/docs/guide/win32?
No, I'm saying to move 1.0/win32 to 1.0/os/win32, and leave the 1.0/os/ directory ready for other OSes.
So if someone grabs the PDF of the guide, he doesn't get the OS specific parts. On the other hand if we put them all in the guide, then the PDF will be bloated with stuff not interesting to all. But still it's better to have more than less, don't you think? I know a bunch of people who simply print out the guide's PDF, bind it and give to their employees to read.
I'm in favor of having OS specific details in their own documents. This will allow to have separate maintainers do their best without stepping on each other toes.
But would like to hear other opinions whether to have these OS-specific chapters in the guide or in parallel to it?
Good point. Well, in that case, we could make them a group inside the guide. The only problem I might see is this:
Part LXXXVIII:) OS-specific information
- Win32 compile - Win32 install - Win32 issues - Win32 foo - Cygwin installation - MacOS X instructions
As the amount of Win32 information we have is quite large, that might be an issue. However, we could put those into just "Windows" and make them sub-sections of that document.
I thought of:
guide/index.html: ----------------- Part II: OS-specific information
Win32 OSX ...
each pointing to the docset of its own. So all you need to do is
1. mv docs/1.0/win32 docs/1.0/guide/win32
2. remove it from docs/1.0/config.cfg and put it into docs/1.0/guide/config.cfg
3. find . -type f -exec perl pi -e 's|win32::|guide::win32::|' {} \;cet tout __________________________________________________________________ Stas Bekman JAm_pH ------> Just Another mod_perl Hacker http://stason.org/ mod_perl Guide ---> http://perl.apache.org mailto:[EMAIL PROTECTED] http://use.perl.org http://apacheweek.com http://modperlbook.org http://apache.org http://ticketmaster.com
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
