From: Vincent Belaïche Date: Mon, 1 Jan 2024 18:49:29 +0000 (+0100) Subject: SES manual clean-up any « ignore »'d text to be translated X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=69c98b0e70ba763df481e6ee7b1c73fbd8754050;p=emacs.git SES manual clean-up any « ignore »'d text to be translated Remove from the English version any ignore'd chunk of text that has been contributed yet only in the French version, and let only the comment indicating re-alignment is needed. --- diff --git a/doc/misc/ses.texi b/doc/misc/ses.texi index 470a5539b4f..3422825aaee 100644 --- a/doc/misc/ses.texi +++ b/doc/misc/ses.texi @@ -166,53 +166,7 @@ using e.g., @kbd{M-p ("%s")}. Enclosing @code{"%s"} into a list tells @acronym{SES} to align left. You can override a column's printer function in any individual cell using @kbd{p}. -@c TODO : translate the sequel from French. -@ignore -Vous pouvez nommer une fonction d'impression, et utiliser le nom de la -fonction à la place de sa définition, de sorte à faciliter la -modification de l'impression de toutes les cellules utilisant cette -fonction. Par exemple tapez @kbd{M-x -ses-define-local-printer@key{ret}}, puis @kbd{note@key{ret}}, puis -@kbd{("%s")} pour définir une fonction d'impression nommée @code{note} -dont la définition est @code{("%s")}, puis sur la colonne @samp{B} tapez -@kbd{M-p note@key{ret}} - -@example -@group -A B - Revenu - 2.23 Frais de consultation - 0.02 Opinion informée - 15.76 Stand limonade - -4 Prêt à Joseph - 14.01 Total -@end group -@end example - -Si maintenant vous redéfinissez @code{note} avec pour nouvelle -définition @kbd{("*%s")} qui ajoute une astérisque @code{*} devant le -texte, la zone d'impression est modifiée ainsi: -@example -@group -A B - Revenu - 2.23 *Frais de consultation - 0.02 *Opinion informée - 15.76 *Stand limonade - -4 *Prêt à Joseph - 14.01 *Total -@end group -@end example - -Notez que la cellule @samp{B1} reste affichée vide et n’est pas -affichée comme @samp{*}. C’est parce que la valeur de la cellule est -@code{nil}, et que les fonctions d’impression définies à partir d’une -chaîne de formatage comme @code{"%s"} dans @code{("%s")} impriment -systématiquement @code{nil} comme une chaîne vide, et tentent -d’imprimer toute valeur non-@code{nil} en utilisant la fonction -standarde @code{format} avec la chaîne de formatage, et si cela -échoue, utilisent la fonction de repli @code{ses-prin1} la place. -@end ignore +@c TODO : propagate extra explanation from the French version. If Joe pays back his loan, you might blank that entry; e.g., by positioning the cursor in cell A5 and pressing @kbd{C-d}. If you do @@ -806,11 +760,9 @@ column width is 7 and the default printer is @samp{"%.7g"}. Each of these can be customized. Look in group ``ses''. After entering a cell value, normally, @code{forward-char} is called, -which moves point right to the next cell@c TODO translate from French -@ignore -, ou à la première cellule à gauche de la ligne suivante si la -cellule courante est la plus à droite de la feuille -@end ignore +which moves point right to the next cell@c TODO propagate extra + @c explanation from the French + @c version. . You can customize @code{ses-after-entry-functions} to move left or up or down. For diagonal movement, select two functions from the list. @@ -819,10 +771,7 @@ list. @code{ses-jump-cell-name-function} is a customizable variable by default set to the @code{upcase} function. This function is called when you pass a cell name to the @command{ses-jump} command (@kbd{j}), -@c TODO translate from French -@ignore -, et que ce nom n'est pas le nom d'une cellule renommée. -@end ignore +@c TODO : propagate extra explanation from the French version. it changes the entered cell name to that where to jump. The default setting @code{upcase} allows you to enter the cell name in low case. Another use of @code{ses-jump-cell-name-function} could be some @@ -1118,30 +1067,7 @@ nothing is printed for it. producing a value: the print cell is filled with hash marks (#). @end itemize -@c TODO translate from French -@ignore -Lorsque la fonction d'impression est définie par une chaîne de -formatage, par ex. @samp{"%.3f"}, @acronym{SES} imprime -automatiquement @code{nil} comme une chaîne vide, mais si la fonction -d'impression est définie par une expression lambda, vous devez définir -explicitement comment @code{nil} est traité, par ex. : -@example -(lambda (x) - (cond - ((null x) "") - ((stringp x) (list x)) - ((numberp x) (format "%.3f" x)) - (t (ses-prin1 x))) -@end example -imprime @code{nil} comme une chaîne vide, aligne à gauche la valeur si -c'est une chaîne, et si c'est un nombre l'aligne à droite en -l'imprimant avec trois décimales. - -Il n'est pas nécessaire par contre que vous vous souciez de -@code{'*skip*} dans la définition d'une fonction d'impression, en -effet aucune fonction d'impression n'est appelée sur @code{'*skip*}. -@end ignore - +@c TODO propagate extra explanation from the French version. If the result from the printer function is too wide for the cell and the following cell is @code{nil}, the result will spill over into the @@ -1255,15 +1181,7 @@ Arguably one could specify only @var{fromrange} plus @var{to-row-offset} and @var{to-column-offset}. The @var{torange} is stated explicitly to ensure that the formula will be recalculated if any cell in either range is changed. -@c TODO reword this paragraph more clearly as follows: -@ignore -Vous vous demandez peut-être pourquoi les arguments de -@code{ses-select} ne consistent pas au lieu de @var{à-plage} de -décalages @var{décalage-à-la-ligne} et @var{décalage-à-la-colonne} -relativement à @var{de-plage} : spécifier @var{à-plage} explicitement -assure que la formule est recalculée si l'une quelconque des cellules -de cette plage est modifiée. -@end ignore +@c TODO reword this paragraph more clearly as in the French version File @file{etc/ses-example.el} in the Emacs distribution is an example of a