Bug #17646 Updated: use only one version of each manual page

ID: 17646 Updated by: mitja@doticni.net Reported By: mitja@doticni.net Status: Open Bug Type: Website problem Operating System: any PHP Version: 4.2.1 New Comment: So the printable version doesn't need to get PHP-processed, but can be just sent away. The amount of code would also be very low - my guess is around 300 bytes a file. Previous Comments: ------------------------------------------------------------------------ [2002-06-07 12:37:23] goba@php.net I still cannot see the point in putting PHP code deep into HTML comments... Why to serve PHP code in HTML comment (more bandwith when serving HTML files alone), and making it harder to recognize the PHP code? Even as the non-printed manual pages are used much more often, then the HTML versions. So IMHO the PHP format should be a base, and not the HTML one. ------------------------------------------------------------------------ [2002-06-07 12:26:28] mitja@doticni.net After #17644 is done, the manual pages could be reworked so that only one page per language is needed, instead of two (print/non-print). I suggest this is done so that the printable version is seen when the file is passed straight to browser (something.html), and the displayable version is shown when the same file is processed through PHP. Something like this: <!--<? manualHeader(...); if ($print) { ?>--> print-only stuff <!--<? } ?>--> stuff common to both <!--<? if (!$hidenotes) { ?>--> notes <!--<? } manualFooter(...); ?>--> Then, non-existing directories could be used for the displayable version, which would pass the request through error.php, which would include the neccesary logic. This would cut the number of files on the site in half, and the disk space requirements for a mirror (together with #17644) even more. Additionally, it would be easy to both show and not show notes in the printable layout, again with using no additional files on the servers. ------------------------------------------------------------------------ -- Edit this bug report at http://bugs.php.net/?id=17646&edit=1