For most languages a single standard for documenting functions and methods in block comments (a.k.a. doc-blocks) has emerged.
For BASH, however, there does not seem to be a definitive convention. Several competing conventions exist, which made me think:
Could a list of doc-block tags be distilled from those used across all (or most) languages?
Time to find out!
| Map | Action |
|---|---|
| <F1> | Causes Netrw to issue help |
| <cr> | Netrw will enter the directory or read the file |
| <del> | Netrw will attempt to remove the file/directory |
| - | Makes Netrw go up one directory |
| a | Toggles between normal display, hiding (suppress display of files matching g:netrw_list_hide) showing (display only files which match g:netrw_list_hide) |
| c | Make browsing directory the current directory |
| C | Setting the editing window |
| d | Make a directory |
| <?php | |
| print "<pre>"; | |
| $urls = [ | |
| [ | |
| 'url' => 'https://badssl.com/', | |
| 'expected_http' => 200, | |
| 'expected_curl_errno' => 0, | |
| 'expected_curl_error' => '', |
| <?php | |
| /** Disclaimer: in-progress **/ | |
| /** | |
| * The component function. c(). | |
| * Usage: | |
| * c($component_name, $data, [$attributes], [$options]); | |
| */ |
| function findfunc { | |
| grep -rn "function $1(" `drush dd`| grep -vP "tags|patch$"| awk -F':' '{print $1,$2}' | | |
| while read FILE LINE | |
| do | |
| mate -l ${LINE} ${FILE} | |
| done | |
| } |