--- Comment #3 from Bawolff <> 2010-10-23 21:13:11 UTC ---
(In reply to comment #2)
> First, there should be a comment in the file saying 'for instructions use
> $ php edit.php --help'

That's pretty standard, I think we can presume that people have a basic
knowledge of the unix convention that commandName --help gives them help.
Failing that they can look at mediawiki wiki where this is also documented.
Furthermore just running it without any arguments will also give the help

> Then the should be an example of how one could use it to say add a line
> at the third line of a file:
> wget -O Food
> ed Food <<EOF
> 3i
> bla bla
> .
> w
> q
> php edit.php Food < Food
> Wait, what do I see in getText.php!:
>  * Outputs page text to stdout, useful for command-line editing automation.
>  * Example: php getText.php "page title" | sed -e '...' | php edit.php "page
> title"
> Well, if only that example also was there in the edit.php usage message...

Perhaps an example would be useful (I added one to ) on the other hand its not
really the job of these help messages to teach basic unix concepts. A person
using one of these scripts should (hopefully) know what edit the article given
as the last argument with the text from stdin means (but thats just imho).

Configure bugmail:
------- You are receiving this mail because: -------
You are the assignee for the bug.
You are on the CC list for the bug.

Wikibugs-l mailing list

Reply via email to