Doc #74237 [NEW]: Missing link to ref for further info on problems and missing info on packages

From: Date: Sat, 11 Mar 2017 12:16:35 +0000
Subject: Doc #74237 [NEW]: Missing link to ref for further info on problems and missing info on packages
Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-14494@lists.php.net to get a copy of this message
From:             markjballard at googlemail dot com
Operating system: linux
PHP version:      Irrelevant
Package:          Documentation problem
Bug Type:         Documentation Problem
Bug description:Missing link to ref for further info on problems and missing info on packages

Description:
------------
---
From manual page: http://www.php.net/install.unix.debian
---
The manual page says look elsewhere if there's a problem with php on a
debian system because its probably a problem with the debain
configuration:

"If the PHP scripts are not parsing via the web server, then it's likely
that PHP was not added to the web server's configuration file, which on
Debian may be /etc/apache2/apache2.conf or similar. See the Debian
manual for further details."

But it neglects to provide a link to the manual where this help can be
found. When you go looking, you learn that the debian manaual pages are
a maze.

Telling users to go look elsewhere if php doesn't work is, moreover
passing the buck.

The page also seems to discuss the installation as though the writer
imagined he was addressing his advice to people who were already experts
on the topic.

It talks loosely of a need to install various php packages without
saying clearly what php packages are available, which ones need to be
installed and, of the others, why you might want to install them. A
simple list would help, with links to further info. 

Using the apt-cache search instruction the page suggests using to see
what packages are available produces a small list that contains none of
those packages referenced in the example install instructions.


-- 
Edit bug report at https://bugs.php.net/bug.php?id=74237&edit=1
-- 
Try a snapshot (PHP 5.4):   https://bugs.php.net/fix.php?id=74237&r=trysnapshot54
Try a snapshot (PHP 5.5):   https://bugs.php.net/fix.php?id=74237&r=trysnapshot55
Try a snapshot (trunk):     https://bugs.php.net/fix.php?id=74237&r=trysnapshottrunk
Fixed in SVN:               https://bugs.php.net/fix.php?id=74237&r=fixed
Fixed in release:           https://bugs.php.net/fix.php?id=74237&r=alreadyfixed
Need backtrace:             https://bugs.php.net/fix.php?id=74237&r=needtrace
Need Reproduce Script:      https://bugs.php.net/fix.php?id=74237&r=needscript
Try newer version:          https://bugs.php.net/fix.php?id=74237&r=oldversion
Not developer issue:        https://bugs.php.net/fix.php?id=74237&r=support
Expected behavior:          https://bugs.php.net/fix.php?id=74237&r=notwrong
Not enough info:            https://bugs.php.net/fix.php?id=74237&r=notenoughinfo
Submitted twice:            https://bugs.php.net/fix.php?id=74237&r=submittedtwice
register_globals:           https://bugs.php.net/fix.php?id=74237&r=globals
PHP 4 support discontinued: https://bugs.php.net/fix.php?id=74237&r=php4
Daylight Savings:           https://bugs.php.net/fix.php?id=74237&r=dst
IIS Stability:              https://bugs.php.net/fix.php?id=74237&r=isapi
Install GNU Sed:            https://bugs.php.net/fix.php?id=74237&r=gnused
Floating point limitations: https://bugs.php.net/fix.php?id=74237&r=float
No Zend Extensions:         https://bugs.php.net/fix.php?id=74237&r=nozend
MySQL Configuration Error:  https://bugs.php.net/fix.php?id=74237&r=mysqlcfg



Thread (3 messages)

« previous php.doc.bugs (#14494) next »