php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #80681 SVN mentions in manual and dochowto
Submitted: 2021-01-28 13:20 UTC Modified: 2021-01-28 15:32 UTC
From: ae@php.net Assigned:
Status: Open Package: Documentation problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If you forgot your password, you can retrieve your password here.
Password:
Status:
Package:
Bug Type:
Summary:
From: ae@php.net
New email:
PHP Version: OS:

 

 [2021-01-28 13:20 UTC] ae@php.net
Description:
------------
The PHP Manual > Appendices > About the manual [1] mentions SVN a lot, so the manual tutorial (dochowto) [2].

They need a rewrite from the recent SVN to git migration.


[1] https://www.php.net/manual/en/about.generate.php and https://www.php.net/manual/en/about.translations.php

[2] http://doc.php.net/tutorial/

Expected result:
----------------
No mention of SVN (or CVS!) sources of the manual.

Actual result:
--------------
"The XML source code may be downloaded from SVN and viewed at » https://svn.php.net/viewvc/."

"People involved in the translations start from the XML source code available from » https://svn.php.net/viewvc/ and from it they translate"

"To checkout the documentation source, use a modified version of the following command where you change {LANG} to a desired language, such as en for only English:

svn checkout https://svn.php.net/repository/phpdoc/modules/doc-{LANG} phpdoc-{LANG}"

"Obtaining SVN access"

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2021-01-28 13:43 UTC] cmb@php.net
Just earlier today I committed a (partial?) fix[1] for the manual.

[1] <https://github.com/php/doc-en/commit/9ffcc250271e62382436b7952691284cd98042f5>
 [2021-01-28 14:37 UTC] ae@php.net
Yes... I opened this bug almost as a reaction from this specific commit, but to track other places that need a revision up to a full rewrite.

But english is not my native language, so I'm not up to the task,
 [2021-01-28 15:32 UTC] cmb@php.net
> But english is not my native language, […]

Few, if any, current doc maintainers are native English speakers.
:)
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Thu Dec 26 22:01:28 2024 UTC