extension-wise (local) macro
| From: | Lytochkin Boris | Date: | Sun, 08 May 2011 16:13:51 +0000 |
| Subject: | extension-wise (local) macro | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969382676@lists.php.net to get a copy of this message | ||
Hi.
Is there any way to create an extension-wise macro and use it in
multiple sections of extension manual?
Simplest example is a manual for snmp*set functions:
http://php.net/manual/en/function.snmpset.php
http://php.net/manual/en/function.snmp2-set.php
http://php.net/manual/en/function.snmp3-set.php
description of parameter "type" is long but nearly identical. Now all
this text is stored as three copies in different documents.
Currently I'm working on documentation for new OO API of SNMP
extension and there will be another set method containing the same
type parameter and it's long description.
So my idea is to put common part of this text into some "entity" and
place a reference to it in all docs where needed.
Is there a correct way to do this?
Quick look at other docs/ml archive didn't help.
Thanks.
--
Boris