Una recomendaci�n, poneros de acuerdo con el desarrollador para
escribir la p�gina de manual/aclarar lo que hace (a ves no es tan obvio y el
desarrollador sabr� en el 100% de los casos, bueno, 99% qu� es lo que hace
:)
Y ya de paso, si las traduc�s al espa�ol me las mandais a m� para
que las incluya en el paqute manpages-es, al desarrollador original para que
la incluya en las fuentes y tambi�n a insflug (si no me equivoco llevan
lleogs las p�ginas de man...)
Javi
On Mon, Apr 02, 2001 at 08:22:28AM +0100, Luis Arocha -Data- wrote:
> Hola a todos,
>
> Como ver�is por el mensaje adjunto el grupo de control de calidad del
> proyecto Debian ha solicitado ayuda para realizar ciertas tareas:
> - Corregir errores.
> - Ayudar en la transici�n de /usr/doc --> /usr/share/doc
> - Crear p�ginas de manual.
>
> De las tres tareas �sta �ltima es la m�s f�cil y en la que CUALQUIERA
> que
> sepa lo que es un editor de textos puede ayudar. Se trata de crear
> p�ginas
> de manual para muchos programas que no la tienen.
>
> Realmente es muy f�cil.
>
> �Qu� hay que hacer?
> - Escoger de la lista que propone Martin Michlmayr el programa
> que m�s te guste/que m�s odies/que m�s uses.
> - Bajarte los fuentes de unstable.
> - Mirar la salida prevista en caso de ejecutar el comando on la
> opci�n --help y, si fuera necesario, echar un vistazo al resto
> de las fuentes.
> - Escribir unos pocos p�rrafos en ingl�s con la descripci�n,
> opciones, valores de retorno, variables de entorno, etc�tera.
> - Formatear el texto en el formato de man. (En mi caso yo pienso
> usar el formato POD de perl, que es mucho m�s sencillo de usar,
> y despu�s con el comando pod2man... voil�)
> - Enviar el fichero resultante a Bug Tracking System.
>
> Y YA EST�. Ya habr�s contribuido al proyecto Debian.
>
> Si alguien tiene inter�s estoy preparando una plantilla en formato POD
> para crear las p�ginas de manual con el comando pod2man y estoy a
> disposici�n de qui�n tenga problemas con alg�n paso.
>
> Animo. Recordad que Debian est� realizada enteramente por voluntarios
>
> ----- Forwarded message from Martin Michlmayr <[EMAIL PROTECTED]> -----
>
> Date: Sun, 1 Apr 2001 02:23:43 +0100
> From: Martin Michlmayr <[EMAIL PROTECTED]>
> Reply-To: [email protected]
> To: [email protected]
> Cc: [email protected]
> User-Agent: Mutt/1.2.5i
> Subject: Your help with QA is needed
>
> I added some stuff to the QA web site. Those people who always
> said that QA's tasks are not well defined can stop complaining.
> There's plenty of work listed on the web site now:
>
> - Help fix bugs in the base. Currently, the base has over 1500
> bugs, including 23 RC bugs. Please send in patches through
> the BTS. See http://qa.debian.org/base-bugs.html for a full list.
> Since base is going to be frozen before the rest of the system,
> it is very important that we fix as many bugs as possible and
> as as soon as possible.
>
> - FHS transition: More than 300 packages still put data in /usr/doc
> and /usr/man. Please send in patches and NMU after 3 weeks.
> See http://qa.debian.org/fhs.html
>
> - Write man pages: About 650 binaries in Debian do not have a man
> page. See http://qa.debian.org/man-pages.html for a listing.
>
>
> Visit http://qa.debian.org for more information. More will be added
> soon.
>
> --
> Martin Michlmayr
> [EMAIL PROTECTED]
>
>
> --
> To UNSUBSCRIBE, email to [EMAIL PROTECTED]
> with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
> debian.org
>
>
>
> ----- End forwarded message -----
>
> --
> O / >O >O >O >O O / O / O / O / >O Luis Arocha "Data"
> \__|/____|__|__|__|/ \__|/__|/__|/__|/____|/larocha at wanadoo.es
> \ \ \ \ \ Islas Canarias
> \ \ \ \ \ Spain
>
>
>
>
> --
> Unsubscribe? mail -s unsubscribe [EMAIL PROTECTED] < /dev/null
>
