[Maxima-commits] CVS: maxima/doc/info/es unit.texi,1.1,1.2

[Mario R. R. <rio...@us...>]

Update of /cvsroot/maxima/maxima/doc/info/es
In directory sc8-pr-cvs7.sourceforge.net:/tmp/cvs-serv5525/doc/info/es

Modified Files:
	unit.texi 
Log Message:

* doc/info/unit.texi: changes were made to fit general texi files policy.
* doc/info/es/unit.texi: Spanish translation of the above file.
* src/init-cl.lisp: added contrib/unit to file_search variable.
* share/contrib/unit/unit.mac: renamed forget function to avoid
    conflicts with forget in contexts. forget in unit is now uforget.


Index: unit.texi
===================================================================
RCS file: /cvsroot/maxima/maxima/doc/info/es/unit.texi,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- unit.texi	28 Feb 2006 23:31:19 -0000	1.1
+++ unit.texi	23 May 2006 21:44:24 -0000	1.2
@@ -1,3 +1,4 @@
+@c english version 1.2
 @menu
 * Introducci@'on a Units::       
 * Definiciones para Units::       
@@ -6,37 +7,36 @@
 @node Introducci@'on a Units, Definiciones para Units, unit, unit
 @section Introducci@'on a Units
 
-The @emph{unit} package enables the user to convert between arbitrary
-units and work with dimensions in equations. The functioning of this package
-is radically different from the original Maxima units package - whereas the
-original was a basic list of definitions, this package uses rulesets to allow
-the user to chose, on a per dimension basis, what unit final answers should be
-rendered in.  It will separate units instead of intermixing them in the display,
-allowing the user to readily identify the units associated with a particular
-answer.  It will allow a user to simplify an expression to its fundamental Base
-Units, as well as providing fine control over simplifying to derived units.
-Dimensional analysis is possible, and a variety of tools are available to 
-manage conversion and simplification options. In addition to customizable 
-automatic conversion, @emph{units} also provides a traditional manual 
-conversion option.  
+El paquete @code{unit} permite al usuario hacer cambios de unidades y
+llevar a cabo el an@'alisis dimensional de las ecuaciones. La forma de operar de
+este paquete es radicalmente diferente de la del paquete original de Maxima;
+mientras que en el paquete original era tan solo una lista de definiciones,
+aqu@'{@dotless{i}} se utiliza un conjunto de reglas que permiten seleccionar al usuario
+en qu@'e unidades debe devolverse la expresi@'on final. 
 
-Note - when unit conversions are inexact Maxima will make approximations resulting 
-in fractions. This is a consequence of the techniques used to simplify units.
-The messages warning of this type of substitution are disabled by default in 
-the case of units (normally they are on) since this situation occurs frequently
-and the warnings clutter the output.  (The existing state of ratprint is restored
-after unit conversions, so user changes to that setting will be preserved 
-otherwise.)  If  the user needs this information for units, they can set 
-@emph{unitverbose:on} to reactivate the printing of warnings from the unit 
-conversion process.
+Junto con el an@'alisis dimensional, el paquete aporta una serie de 
+herramientas para controlar las opciones de conversi@'on y simplificaci@'on.
+Adem@'as de la conversi@'on autom@'atica adaptable a las necesidades del
+usuario, el paquete @code{unit} permite hacer conversiones a la manera
+tradicional.
 
-@subsubsection Loading @emph{unit}
+Nota: Cuando los factores de conversi@'on no son exactos, Maxima los
+transformar@'a a fracciones como consecuencia de la metodolog@'{@dotless{i}}a
+utilizada para simplificar las unidades. Los mensajes de aviso concernientes a
+estas transformaciones est@'an desactivados por defecto en el caso de las
+unidades (lo habitual es que est@'en activados en otros contextos) debido a
+que al ser una operaci@'on muy frecuente, ser@'{@dotless{i}}an un estorbo. 
+El estado previo de la variable @code{ratprint} queda restaurado tras la
+conversi@'on de las unidades, de manera que se mantendr@'a la opci@'on
+seleccionada por el usuario; en caso de que @'este necesite ver dichos 
+avisos, podr@'a hacer la asignaci@'on @code{unitverbose:on} para
+reactivarlos desde el proceso de conversi@'on de unidades.
 
-@emph{unit} is included in Maxima in the share/contrib/unit directory. It obeys
-normal Maxima package loading conventions:
+El paquete @code{unit} se aloja en el directorio @code{share/contrib/unit}
+y se ajusta a las convenciones de Maxima para la carga de paquetes:
 
 @example
-(%i1) load("share/contrib/unit.mac");
+(%i1) load("unit")$
 ******************************************************************* 
 *                       Units version 0.50                        * 
 *          Definitions based on the NIST Reference on             * 
@@ -46,28 +46,36 @@
 ******************************************************************* 
  
 Redefining necessary functions... 
-STYLE-WARNING: redefining TOPLEVEL-MACSYMA-EVAL in DEFUN
-STYLE-WARNING: redefining MSETCHK in DEFUN
-STYLE-WARNING: redefining KILL1 in DEFUN
-STYLE-WARNING: redefining NFORMAT in DEFUN
+WARNING: DEFUN/DEFMACRO: redefining function TOPLEVEL-MACSYMA-EVAL ...
+WARNING: DEFUN/DEFMACRO: redefining function MSETCHK ...
+WARNING: DEFUN/DEFMACRO: redefining function KILL1 ...
+WARNING: DEFUN/DEFMACRO: redefining function NFORMAT ...
 Initializing unit arrays... 
 Done. 
-(%o1)   /usr/local/share/maxima/5.9.1.1cvs/share/contrib/unit/unit.mac
 @end example
 
-The STYLE-WARNING messages are expected and not a cause for concern - they indicate
-the @emph{unit} package is redefining functions already defined in Maxima proper.  
-This is necessary in order to properly handle units.  The user
-should be aware that if other changes have been made to these functions by other
-packages those changes will be overwritten by this loading process.
+Los avisos del tipo @code{WARNING} son normales y no deben interpretarse
+como errores; tan solo indican que el paquete @code{unit} est@'a redefiniendo
+funciones que ya estaban definidas en Maxima. Esto es necesario para que las
+unidades se gestionen de forma correcta. El usuario debe tener en cuenta que si 
+otros paquetes han cambiado las definiciones de estas funciones, tales cambios ser@'an
+ignorados por el proceso de carga de @code{unit}.
 
-The @emph{unit.mac} file also loads a lisp file @emph{unit-functions.lisp} which
-contains the lisp functions needed for the package.
+El paquete @code{unit} tambi@'en carga el fichero de Lisp @code{unit-functions.lisp},
+el cual contiene las funciones Lisp necesarias.
 
-@subsubsection Basic Usage
+El autor principal de este paquete es Clifford Yapp, quien ha recibido ayuda
+y asistencia, entre otros, de Barton Willis y Robert Dodier.
+
+@node Definiciones para Units,  , Introducci@'on a Units, unit
+@section Definiciones para Units
+
+
+@deffn {Funci@'on} setunits (@var{list})
+
+El paquete @code{unit} no utiliza por defecto dimensiones derivadas, pero convierte
+todas las unidades a las siete fundamentales en unidades MKS.
 
-By default, the @emph{unit} package does not use any derived dimensions, but will
-convert all units to the seven fundamental dimensions using MKS units.
 @example
 (%i2) N;
                                      kg m
@@ -89,8 +97,10 @@
                              1800000000000     2
                                               s
 @end example
-In some cases this is the desired behavior.  If the user wishes to use other
-units, this is achieved with the @code{setunits} command:
+
+Este es el comportamiento que se desea en ciertos casos. Si
+el usuario necesita utilizar otras unidades, habr@'a de utilizar la
+instrucci@'on @code{setunits}:
 @example
 (%i6) setunits([centigram,inch,minute]);
 (%o6)                                done
@@ -112,9 +122,10 @@
                                         2
                                     %min
 @end example
-The setting of units is quite flexible.  For example, if we want to
-get back to kilograms, meters, and seconds as defaults for those
-dimensions we can do:
+
+La especificaci@'on de las variables es relativamente flexible.
+Por ejemplo, si se quiere volver a utilizar kilogramos, metros y
+segundos como unidades por defecto, podemos hacer:
 @example
 (%i11) setunits([kg,m,s]);
 (%o11)                               done
@@ -124,25 +135,8 @@
                              1800000000000     2
                                               s
 @end example
-Or, alternately, if one wishes to restore the default behavior for
-a particular dimension:
-@example
-(%i13) setunits([centigram,inch,minute]);
-(%o13)                               done
-(%i14) centigram*inch/minutes^2;
-                                    %in cg
-(%o14)                              ------
-                                        2
-                                    %min
-(%i15) forget([cg,%in,%min]);
-(%o15)                        [done, done, done]
-(%i16) centigram*inch/minutes^2;
-                                  127        kg m
-(%o16)                      (-------------) (----)
-                             1800000000000     2
-                                              s
-@end example
-Derived units are also handled by these commands:
+
+Las unidades derivadas tambi@'en se controlan con esta misma instrucci@'on:
 @example
 (%i17) setunits(N);
 (%o17)                               done
@@ -159,10 +153,12 @@
 (%o21)                        (-------------) (N)
                                1800000000000
 @end example
-Notice that the @emph{unit} package recognized the non MKS combination
-of mass, length, and inverse time squared as a force, and converted it
-to Newtons.  This is how Maxima works in general.  If, for example, we
-prefer dyne to Newtons, we simply do the following:
+
+T@'engase en cuenta que el paquete @code{unit} reconoce que la
+combinaci@'on de masa, longitud e inversa del cuadrado del tiempo da
+lugar a una fuerza, convirti@'endola a newtons. Esta es la forma
+general en la que trabaja Maxima. Si el usuario prefiere dinas a newtons,
+tan solo tendr@'a que hacer lo siguiente:
 @example
 (%i22) setunits(dyn);
 (%o22)                               done
@@ -173,10 +169,11 @@
 (%o24)                         (--------) (dyn)
                                 18000000
 @end example
-To discontinue simplifying to any force, we use the forget command:
+
+Para desactivar una unidad se utiliza la instrucci@'on @code{uforget}:
 @example
-(%i26) forget(dyn);
-(%o26)                               done
+(%i26) uforget(dyn);
+(%o26)                               false
 (%i27) kg*m/s^2;
                                      kg m
 (%o27)                               ----
@@ -188,24 +185,58 @@
                              1800000000000     2
                                               s
 @end example
-This would have worked equally well with @code{forget(N)} or 
-@code{forget(%force)}.  @code{forget} operates on dimensions,
-not units, so any unit of a particular dimension will work.  The
-dimension itself is also a legal argument.
+Esto tambi@'en hubiese funcionado con @code{uforget(N)} o
+@code{uforget(%force)}. 
 
-@subsubsection @code{convert}
 
-When resetting the global environment is overkill, there is the @code{convert}
-command, which allows one time conversions.  It can accept either a single
-argument or a list of units to use in conversion.  When a convert operation is
-done, the normal global evaluation system is bypassed, in order to avoid the
-desired result being converted again.  As a consequence, for inexact calculations
-"rat" warnings will be visible if the global environment controlling this behavior
-(@code{ratprint}) is true.  This is also useful for spot-checking the
-accuracy of a global conversion.  Another feature is @code{convert} will allow a
-user to do Base Dimension conversions even if the global environment is set to
-simplify to a Derived Dimension.
+V@'ease tambi@'en @code{uforget}. Para hacer uso de esta funci@'on ejec@'utese @code{load("unit")}.
+@end deffn
 
+
+@deffn {Funci@'on} uforget (@var{list})
+Por defecto, el paquete @code{unit} convierte todas las unidades a las
+siete fundamentales del sistema MKS. Este comportamiento puede alterarse
+mediante la instrucci@'on @code{setunits}. Despu@'es, si el usuario quiere
+restaurar el comportamiento por defecto podr@'a hacerlo para una dimensi@'on
+determinada haciendo uso de la instrucci@'on @code{uforget}:
+@example
+(%i13) setunits([centigram,inch,minute]);
+(%o13)                               done
+(%i14) centigram*inch/minutes^2;
+                                    %in cg
+(%o14)                              ------
+                                        2
+                                    %min
+(%i15) uforget([cg,%in,%min]);
+(%o15)                     [false, false, false]
+(%i16) centigram*inch/minutes^2;
+                                  127        kg m
+(%o16)                      (-------------) (----)
+                             1800000000000     2
+                                              s
+@end example
+
+La instrucci@'on @code{uforget} opera
+sobre dimensiones, no sobre unidades, de modo que valdr@'a para
+cualquier unidad de una dimensi@'on concreta. La propia dimensi@'on
+es una argumento v@'alido para esta funci@'on.
+
+V@'ease tambi@'en @code{setunits}. Para hacer uso de esta funci@'on ejec@'utese @code{load("unit")}.
+@end deffn
+
+
+@deffn {Funci@'on} convert (@var{expr}, @var{list})
+La funci@'on @code{convert} permite conversiones de una sola vez sin
+alterar el entorno global de ejecuci@'on. Acepta tanto un @'unico argumento
+como una lista de unidades a utilizar en las conversiones. Cuando se realiza
+una llamada a @code{convert} se ignora el sistema global de evaluaci@'on, con 
+el fin de evitar que el resultado deseado sea nuevamente transformado.
+Como consecuencia de esto, en los c@'alculos con decimales, los avisos de
+tipo @code{rat} se har@'an visibles si la variable global @code{ratprint}
+vale @code{true}. Otra propiedad de @code{convert} es que permite al
+usuario hacer conversiones al sistema fundamental de dimensiones incluso
+cuando el entorno ha sido ajustado para simplificar a una dimensi@'on
+derivada.
 @example
 (%i2) kg*m/s^2;
                                      kg m
@@ -221,7 +252,7 @@
 
 `rat' replaced 39.37007874015748 by 5000//127 = 39.37007874015748
                               18000000000   %in g
-(%o4)                       (-----------) (-----)
+(%o4)                        (-----------) (-----)
                                   127           2
                                             %min
 (%i5) convert(kg*m/s^2,[N]);
@@ -246,7 +277,7 @@
 (%o12)                               done
 (%i13) kg*m/s^2;
 (%o13)                                 N
-(%i14) forget(N);
+(%i14) uforget(N);
 (%o14)                               false
 (%i15) kg*m/s^2;
                                 5000000   %in g
@@ -262,25 +293,30 @@
                                            s
 @end example
 
-TODO : dimension functionality, handling of temperature, 
-showabbr and friends.  Show examples with addition of quantities containing
-units.
+V@'eanse tambi@'en @code{setunits} y @code{uforget}.
+Para hacer uso de esta funci@'on ejec@'utese @code{load("unit")}.
+@end deffn
 
-@subsubsection User defaults and resetting @emph{unit} behavior
 
-If a user wishes to have a default unit behavior other than that described,
-they can make use of @emph{maxima-init.mac} and the @emph{usersetunits} 
-variable.  The @emph{unit} package will check on startup to see if this variable 
-has been assigned a list.  If it has, it will use setunits on that list and take 
-the units from that list to be defaults.  @code{forget} will revert to the behavior
-defined by usersetunits over its own defaults.  For example, if we have a
-@emph{maxima-init.mac} file containing:
+@defvr {Variable opcional} usersetunits
+Valor por defecto: ninguno
+
+En caso de que el usuario desee que el comportamiento por defecto del
+paquete @code{unit} sea distinto del descrito, puede hacer uso del
+fichero @code{maxima-init.mac} y de la variable global @code{usersetunits}.
+El paquete @code{unit} comprobar@'a al ser cargado si se le ha dado a esta
+variable una lista de unidades; en caso afirmativo, aplicar@'a @code{setunits}
+a las unidades de esta lista y las utilizar@'a por defecto. Una llamada a la
+funci@'on @code{uforget} permitir@'a retornar al comportamiento establecido
+por defecto por el usuario. Por ejemplo, si en el archivo @code{maxima-init.mac}
+se tiene el siguiente c@'odigo:
 @example
 usersetunits : [N,J];
 @end example
-we would see the following behavior:
+
+observar@'{@dotless{i}}amos el siguiente comportamiento:
 @example
-(%i1) load("./unit.mac");
+(%i1) load("unit")$
 ******************************************************************* 
 *                       Units version 0.50                        * 
 *          Definitions based on the NIST Reference on             * 
@@ -290,15 +326,14 @@
 ******************************************************************* 
  
 Redefining necessary functions... 
-STYLE-WARNING: redefining TOPLEVEL-MACSYMA-EVAL in DEFUN
-STYLE-WARNING: redefining MSETCHK in DEFUN
-STYLE-WARNING: redefining KILL1 in DEFUN
-STYLE-WARNING: redefining NFORMAT in DEFUN
+WARNING: DEFUN/DEFMACRO: redefining function TOPLEVEL-MACSYMA-EVAL ...
+WARNING: DEFUN/DEFMACRO: redefining function MSETCHK ...
+WARNING: DEFUN/DEFMACRO: redefining function KILL1 ...
+WARNING: DEFUN/DEFMACRO: redefining function NFORMAT ...
 Initializing unit arrays... 
 Done. 
 User defaults found... 
 User defaults initialized. 
-(%o1)                             ./unit.mac
 (%i2) kg*m/s^2;
 (%o2)                                  N
 (%i3) kg*m^2/s^2;
@@ -317,8 +352,8 @@
 (%o9)                    (6241509596477042688) (eV m)
 (%i10) kg*m*km/s^2;
 (%o10)                   (6241509596477042688000) (eV)
-(%i11) forget([dyn,eV]);  
-(%o11)                           [done, done]
+(%i11) uforget([dyn,eV]);  
+(%o11)                           [false, false]
 (%i12) kg*m/s^2;
 (%o12)                                 N
 (%i13) kg*m^2/s^2;
@@ -328,15 +363,18 @@
 (%i15) kg*m*km/s^2;
 (%o15)                            (1000) (J)
 @end example
-Without @code{usersetunits}, the initial inputs would have been converted
-to MKS, and forget would have resulted in a return to MKS rules.  Instead,
-the user preferences are respected in both cases.  Notice these can still
-be overridden if desired.  To completely eliminate this simplification - i.e.
-to have the user defaults reset to factory defaults - the @code{dontusedimension}
-command can be used.  @code{forget} can restore user settings again, but
-only if @code{usedimension} frees it for use.  Alternately,
-@code{kill(usersetunits)} will completely remove all knowledge of the user defaults
-from the session.  Here are some examples of how these various options work.
+
+De no haber hecho uso de @code{usersetunits}, las entradas iniciales hubiesen
+sido convertidas a unidades MKS y cualquier llamada a @code{uforget} hubiese
+retornado tambi@'en a MKS. Sin embargo, las preferencias establecidas por el
+usuario se respetan en ambos casos. Para eliminar las preferencias del usuario
+y volver a utilizar las establecidas por defecto por el paquete @code{unit},
+debe utilizarse la instrucci@'on @code{dontusedimension}. La funci@'on
+@code{uforget} puede restaurar nuevamente las preferencias del usuario, pero
+s@'olo si @code{usedimension} mantiene su valor. Alternativamente, 
+@code{kill(usersetunits)}  eliminar@'a completamente cualquier vestigio de las
+preferencias del usuario durante la sesi@'on actual. V@'eanse a continuaci@'on
+algunos ejemplos de aplicaci@'on de estas opciones:
 @example
 (%i2) kg*m/s^2;
 (%o2)                                  N
@@ -348,8 +386,8 @@
 (%o5)                           (100000) (dyn)
 (%i6) kg*m^2/s^2;
 (%o6)                     (6241509596477042688) (eV)
-(%i7) forget([dyn,eV]);
-(%o7)                            [done, done]
+(%i7) uforget([dyn,eV]);
+(%o7)                            [false, false]
 (%i8) kg*m/s^2;
 (%o8)                                  N
 (%i9) kg*m^2/s^2;
@@ -382,8 +420,8 @@
 (%o16)                               -----
                                        2
                                       s
-(%i17) forget([dyn,eV]);
-(%o17)                           [done, done]
+(%i17) uforget([dyn,eV]);
+(%o17)                         [false, false]
 (%i18) kg*m/s^2;
                                      kg m
 (%o18)                               ----
@@ -420,15 +458,15 @@
 (%o25)                          (100000) (dyn)
 (%i26) kg*m^2/s^2;
 (%o26)                    (6241509596477042688) (eV)
-(%i27) forget([dyn,eV]);
-(%o27)                           [done, done]
+(%i27) uforget([dyn,eV]);
+(%o27)                           [false, false]
 (%i28) kg*m/s^2;
 (%o28)                                 N
 (%i29) kg*m^2/s^2;
 (%o29)                                 J
 (%i30) kill(usersetunits);
 (%o30)                               done
-(%i31) forget([dyn,eV]);
+(%i31) uforget([dyn,eV]);
 (%o31)                          [false, false]
 (%i32) kg*m/s^2;
                                      kg m
@@ -442,64 +480,57 @@
                                        2
                                       s
 @end example
-Unfortunately this wide variety of options is a little confusing at first,
-but once the user grows used to them they should find they have very full
-control over their working environment.
-
-One other significant customization option available is the @code{setunitprefix}
-command.  Normally, abbreviations used in this package are as close to those
-used in standard texts as possible.  Some people, however, prefer to use those
-symbols for normal work and have units labeled in some other fasion. 
-@code{setunitprefix} is provided for this case.  Here is an example of its use:
 
+Desafortunadamente, esta amplia variedad de opciones puede resultar
+confusa en un primer momento, pero una vez se practica un poco con
+ellas, el usuario comprobar@'a que tiene un control absoluto sobre
+su entorno de trabajo.
 
-@subsubsection Bugs
 
-Undoubtedly.  Probably lots of them.  Let me know.  float and numer don't do
-what is expected.
 
-@subsubsection Authors
+@c One other significant customization option available is the @code{setunitprefix}
+@c command.  Normally, abbreviations used in this package are as close to those
+@c used in standard texts as possible.  Some people, however, prefer to use those
+@c symbols for normal work and have units labeled in some other fasion. 
+@c @code{setunitprefix} is provided for this case.  Here is an example of its use:
 
-Clifford Yapp is the primary author.  He has recieved valuable assistance from
-Barton Willis of the University of Nebraska at Kearney (UNK), Robert Dodier, and
-other intrepid folk of the Maxima mailing list.
+@end defvr
 
-@node Definiciones para Units,  , Introducci@'on a Units, unit
-@section Definiciones para Units
+@deffn {Funci@'on} metricexpandall (@var{x})
 
-@deffn {Function} metricexpandall (@var{x})
-Rebuilds global unit lists automatically creating all desired metric units.
-@var{x} is a numerical argument which is used to specify how many metric
-prefixes the user wishes defined.  The arguments are as follows, with each
-higher number defining all lower numbers' units:
+Reconstruye autom@'aticamente las listas globales de unidades creando todas
+los m@'ultiplos y subm@'ultiplos m@'etricos necesarios. El argumento num@'erico 
+@var{x} se utiliza para especificar cu@'antos prefijos num@'ericos quiere 
+utilizar el usuario. Los argumentos son los siguientes:
 @example
-           0 - none. Only base units
-           1 - kilo, centi, milli
-(default)  2 - giga, mega, kilo, hecto, deka, deci, centi, milli, micro, nano
-           3 - peta, tera, giga, mega, kilo, hecto, deka, deci, centi, milli, 
-               micro, nano, pico, femto
-           4 - all
+               0 - none. Only base units
+               1 - kilo, centi, milli
+(por defecto)  2 - giga, mega, kilo, hecto, deka, deci, centi,
+                   milli, micro, nano
+               3 - peta, tera, giga, mega, kilo, hecto, deka,
+                   deci, centi, milli, micro, nano, pico, 
+                   femto
+               4 - todos
 @end example
-Normally, Maxima will not define the full expansion since this results in a
-very large number of units, but @code{metricexpandall} can be used to
-rebuild the list in a more or less complete fashion. The relevant variable
-in the @emph{unit.mac} file is @var{%unitexpand}.
-@c This should be made configurable as a maxima-init.mac controllable option.
-@end deffn
 
-@defvr {Variable} %unitexpand
-Default value: @code{2}
+Normalmente, Maxima no definir@'a el juego completo de m@'ultiplos y 
+subm@'ultiplos, lo que implica un n@'umero muy grande de unidades, pero
+@code{metricexpandall} puede utilizarse para reconstruir la lista. La
+variable fundamental del paquete @code{unit} es @code{%unitexpand}.
+@end deffn
 
-This is the value supplied to @code{metricexpandall} during the initial loading
-of @emph{unit}.
+@defvr {Variable opcional} %unitexpand
+Valor por defecto: @code{2}
 
+Es el valor suministrado a @code{metricexpandall} durante la carga del
+paquete @code{unit}.
 @end defvr
 
 
-@deffn {Function} functionname (@var{arg1}, @var{arg2}, ..., @var{argn})
-@end deffn
+@c @deffn {Function} functionname (@var{arg1}, @var{arg2}, ..., @var{argn})
+@c @end deffn
 
-@defvr {Variable} variablename
-Default value: @code{true}
-@end defvr
+@c @defvr {Variable} variablename
+@c Default value: @code{true}
+@c @end defvr