Ticket #5640 (closed enhancement: fixed)
Inline Documentation for general-template.php
| Reported by: |
|
Owned by: |
|
|---|---|---|---|
| Priority: | low | Milestone: | 2.7 |
| Component: | Optimization | Version: | |
| Severity: | trivial | Keywords: | phpdoc has-patch commit |
| Cc: |
Description
PHPdoc effort seeks to complete phpdoc style inline documentation for wp-includes/general-template.php.
Needed to complete:
- Short and Long Descriptions.
- @since version info
- parameter type and description.
- return type and description.
Attachments
Change History
darkdragon — 4 years ago
-
attachment
general-template.phpdoc.r6597.diff
added
jacobsantos — 3 years ago
-
attachment
5640.r8681.diff
added
Inline Documentation for wp_meta() based off of r8681
comment:2
jacobsantos — 3 years ago
- Summary changed from PHPdoc effort for general-template.php to Inline Documentation for general-template.php
- Owner changed from anonymous to westi
- Status changed from new to assigned
Updating these now myself.
comment:5
jacobsantos — 3 years ago
Do you mean documenting the entire file, or do you mean just the patches? I'm working on the easy functions and will be submitting a patch. I don't think I've done any more general-template.php functions. The *-template.php functions are pretty easy now that I think about it, I can't figure why I haven't done them sooner.
That gets the file 80% complete.
Patches for the remaining functions and corrections of what I have already done welcome.
comment:9
jacobsantos — 3 years ago
- Keywords needs-patch added; has-patch removed
Corrections incoming tonight, going to seriously conflict with what I have now.
I use "Display" instead of "Outputs" or "Echos". I use "Retrieve" instead of "Returns".
Awesome so far!
comment:10
westi — 3 years ago
jacobsantos — 3 years ago
-
attachment
5640.r8852.diff
added
Completes with three functions left for inline documentation based off of r8852
jacobsantos — 3 years ago
-
attachment
5640.r8855.diff
added
Two functions left to document, based off of r8855.
jacobsantos — 3 years ago
-
attachment
5640.r8857.diff
added
Finished file inline documentation based off of r8857
comment:11
jacobsantos — 3 years ago
- Keywords has-patch commit added; needs-patch removed
Latest patch completes inline documentation.
comment:12
azaozz — 3 years ago
- Status changed from assigned to closed
- Resolution set to fixed
comment:14
jacobsantos — 19 months ago
The previous comment is spam.

Incomplete documentation for general-template.php based off of r6597