Re: tags de documentacion
| From: | Javier | Date: | Tue, 06 May 2003 17:32:47 +0000 |
| Subject: | Re: tags de documentacion | ||
| References: | 1 2 3 | Groups: | php.general.es |
| Request: | Send a blank email to general-es+get-35893@lists.php.net to get a copy of this message | ||
On 06/05/2003 at 14:11 Andres Ferrando wrote:
>para hacer tu "autorespuesta" mas productiva, podrías decirnos
cómo era
>el tema :-D
>
Lee el manual, salamin !!!! :) Jejeeeee
No, mentira...lo que si no hare es escribir yo, te transcribo del
manual:
As long as you edit source files inside a working directory you can
always find out the state of your files via
cvs status' and cvs log'.
But as soon as you export the files from your development environment
it becomes harder to identify which revisions they are.
CVS can use a mechanism known as keyword substitution (or keyword
expansion) to help identifying the files. Embedded strings of the form
$keyword$ and $keyword:...$ in a file are replaced with strings of the
form $keyword:value$ whenever you obtain a new revision of the file.
Por lo tanto, si en tus ficheros pones en el encabezado de la
documentacion lo siguiente:
/*
* @author $Author$
* @date $Date$
* @version $Revision$
*/
Cuando hagas un export del cvs, los tags que estan entre $ seran
remplazados por los valores del cvs y asi siempre que vayas a tocar un
codigo a un cliente, sabras que rayos estas tocando :)
Esos tags tambien quedaran en tu documentacion hecha con phpdoc y/u
otros y tambien sabras si tu documentacion esta actualizada....a menos
que tengas una regla en Ant que genere el export del cvs y la
documentacion ipso facto.
Solo eso.
El resto, en el capitulo 12 del manual de CVS bajo el titulo Keyword
substitution.
Saludos
<jl>