I have reviewed the API docs in Drush quickly and found a few discrepancies. I fix those and add more documentation in the attached patch.
Thanks for polishing these. I disagree the lowercasing such as
-function hook_COMMAND_validate() { +function drush_hook_command_validate() {
The uppercase signals to the reader that this is variable text and the proper command name should be substituted. Drupal7 uses the same convention. See http://api.drupal.org/api/function/hook_form_FORM_ID_alter/7
Alright, here's a reroll. That also fixes some issues with the @file help that i noticed.
Much better ... I do not understand the example "So if, for example, the + * drush_post_hook() call fails, the following hooks will be called:"
Caqn we use a real world command like dl or updatedb?
I added more clear examples and committed. thanks.
Automatically closed -- issue fixed for 2 weeks with no activity.
Comments
Comment #1
moshe weitzman commentedThanks for polishing these. I disagree the lowercasing such as
The uppercase signals to the reader that this is variable text and the proper command name should be substituted. Drupal7 uses the same convention. See http://api.drupal.org/api/function/hook_form_FORM_ID_alter/7
Comment #2
anarcat commentedAlright, here's a reroll. That also fixes some issues with the @file help that i noticed.
Comment #3
moshe weitzman commentedMuch better ... I do not understand the example "So if, for example, the
+ * drush_post_hook() call fails, the following hooks will be called:"
Caqn we use a real world command like dl or updatedb?
Comment #4
moshe weitzman commentedI added more clear examples and committed. thanks.