cw, commande checkcw

Objectif

Prépare le texte à largeur constante pour la commande troff.

Syntaxe

CW [ + t | t ] [-d] [ -f police] [-l Délimiteur][ -r Délimiteur] [ Fichier...]

checkcw [-l Délimiteur] [ -r Délimiteur] [ Fichier... ]

Descriptif

La commande CW prétraite tous les fichiers troff spécifiés contenant du texte en langue anglaise à typeset dans la largeur constante (police CW) . La commande cw lit l'entrée standard si vous ne spécifiez pas de fichier ou si vous spécifiez un - (signe moins) comme l'un des noms de fichier d'entrée. La commande cw écrit dans la sortie standard.

Etant donné que la sortie résultant de cette commande ressemble à celle des imprimantes de ligne et des postes de travail, utilisez cette commande pour créer des exemples de programmes et de sorties informatiques pour les manuels utilisateur et le texte de programmation. La commande cw génère une sortie distinctive lorsqu'elle est utilisée avec la police Times Roman.

La police CW contient un ensemble de caractères non standard. Tout jeu de caractères avec cette police nécessite un espacement entre caractères et mots différent de celui utilisé pour les polices standard. Par conséquent, vous devez utiliser la commande cw pour prétraiter les documents qui utilisent la police CW.

La police CW contient les 94 caractères d'impression ASCII suivants:

abcdefghijklmnopqrstuvwxyz
ABCDEFGHIJKLMNOPQRSTUVWXYZ
0123456789
!$%&()`'*+@.,/:;=?[]|-_^~"<>{}#\

Cette police contient également 11 caractères non ASCII représentés par des chaînes troff à 4 caractères (dans certains cas, ces chaînes sont attachées à des graphiques non standard).

La commande cw reconnaît cinq lignes de demande ainsi que des délimiteurs définis par l'utilisateur. Les lignes de demande ressemblent à des demandes de macro troff . La commande cw les copie dans leur intégralité dans la sortie. Ainsi, vous pouvez définir les demandes en tant que macros troff ; en fait, .CW et .Les macros CN doivent être définies de la sorte. Les cinq demandes sont les suivantes:

Indicateurs

Article	Descriptif
:Agent CW	Marque le début du texte à définir dans la police CW. Cette demande provoque une interruption. Il peut prendre les mêmes indicateurs (au même format) que ceux disponibles sur la ligne de commande cw .
:Nom usuel	Marque la fin du texte à définir dans la police CW. Cette demande provoque une interruption. Il peut prendre les mêmes indicateurs (au même format) que ceux disponibles sur la ligne de commande cw .
:CD	Modifie les délimiteurs et les paramètres des autres indicateurs. Il peut prendre les mêmes indicateurs (au même format) que ceux disponibles sur la ligne de commande cw . Le but de cette demande est de permettre le changement d'indicateurs autres qu'au début d'un document.
:CP liste-options	Concatène toutes les options (délimitées comme les options de macro troff ), avec les options impaires définies dans la police CW et les options paires définies dans la police en vigueur.
:PC Option-liste	Agit de la même manière que .Macro CP , sauf que les options numérotées paires sont définies dans la police CW et que les options impaires sont définies dans la police dominante.

.CW et .Les demandes CN doivent placer entre crochets le texte qui doit être typé tel qu'il est, à l'aide de la police CW. Normalement, la commande cw fonctionne en mode transparent. Dans ce mode, chaque caractère entre .CW et .Les lignes de demande CN se représentent elles-mêmes, à l'exception de .Demande CD et noms spéciaux à 4 caractères répertoriés précédemment. En particulier, la commande cw provoque tous les . (points) et ' (apostrophes) au début des lignes, et toutes les \ (barres obliques inversées) et les ligatures (telles que fi et ff), à masquer dans la commande troff . Le mode transparent peut être désactivé à l'aide de l'indicateur -t , auquel cas les règles troff normales s'appliquent. Dans les deux cas, la commande cw masque à l'utilisateur l'effet des modifications de police générées par .CW et .Demandes CN .

Vous pouvez également utiliser les indicateurs -l et -r pour définir des délimiteurs avec la même fonction que .Demandes CW et .CN . Ces demandes sont destinées à inclure des mots ou des phrases définis dans la police CW dans le texte en cours d'exécution. La commande cw traite le texte entre délimiteurs comme le texte placé entre crochets par .CW/.Paires CN , à une exception près. Espaces dans .CW/.Les paires CN ont la même largeur que les autres caractères CW, tandis que les espaces dans le texte délimité ont la moitié de la largeur, de sorte qu'ils ont la même largeur que les espaces dans le texte en vigueur. Les délimiteurs n'ont pas de signification particulière dans .CW/.Paires CN .

La commande checkcw vérifie que les délimiteurs de début et de fin ainsi que .CW/.Les paires CN sont correctement équilibrées. Il imprime toutes les lignes de la sélection avec les délimiteurs non concordants.

Remarque :

. Les caractères délimiteurs (point) ou \ (barre oblique inversée) ne doivent pas être utilisés.
Certains caractères CW ne se combinent pas bien avec certains caractères Times Roman ; par exemple, l'espacement entre un CW & (perluète) suivi d'un Times Roman , (virgule). Dans de tels cas, l'utilisation de demandes de demi-espace et de quart d'espace troff peut vous aider.
Le code troff généré par la commande cw est difficile à lire.
Le package de macros mm et le package de macros mv contiennent les définitions de .CW et .Macros CN adaptées à la plupart des utilisateurs. Si vous définissez vos propres macros, assurez-vous que la macro .CW démarre le mode troff no-fill (.nf) et le .La macro CN restaure le mode de remplissage (.fi), le cas échéant.
Lorsqu'elle est définie dans le texte en cours d'exécution, la police CW doit être définie dans la même taille de point que le reste du texte. Dans la matière affichée, par contre, elle peut souvent être avantageusement fixée à 1 point plus petit que la taille de point dominante. La police CW est dimensionnée de sorte que, lorsqu'elle est définie en 9 points, il y a 12 caractères par pouce de colonne.
Les documents contenant du texte CW peuvent également contenir des tableaux et des équations. Dans ce cas, l'ordre de prétraitement doit être la commande cw , la commande tbl et la commande eqn . Généralement, les tableaux ne contiennent pas de texte CW, bien qu'il soit possible d'avoir des éléments dans le tableau définis dans la police CW. Assurez-vous que la commande cw ne modifie pas les informations de format de la commande tbl . Les tentatives de définition d'équations dans la police CW sont généralement infructueuses.
Dans la police CW, la surimpression est plus facilement accomplie avec des retours arrière. En effet, les espaces (et donc les retours à la ligne) sont deux fois moins larges entre les délimiteurs qu'à l'intérieur de .CW/.Les paires CN , deux espaces arrière sont requis pour chaque surimpression entre les délimiteurs.
Certains appareils, comme l'imprimante IBM 3816, n'ont pas de police CW. Vous recevez untroff can't open /usr/lib/font/devNAME/CW.out pour ces unités. La commande troff utilise la police de la position 3 comme police CW.

Article	Descriptif
+ t	Active le mode transparent (valeur par défaut).
t	Désactive le mode transparent.
d	Affiche les paramètres d'indicateur en cours sur la sortie d'erreur standard sous la forme de lignes de commentaire troff . Cet indicateur est destiné au débogage.
f Police	Remplace la valeur de la variable Police par la police de la commande cw (la valeur par défaut est 3, qui remplace la police en gras). L'indicateur -f5 est généralement utilisé pour les éléments qui autorisent plus de quatre polices simultanées.

Remarque: cet indicateur est utile uniquement sur la ligne de commande.

Article	Descriptif
-l Délimiteur	Définit le délimiteur de départ comme la chaîne de 1 ou 2 caractères spécifiée par la variable Délimiteur . Le délimiteur de début n'est pas défini par défaut.
-r Délimiteur	Définit le délimiteur de fin sur celui spécifié par la variable Délimiteur . Le délimiteur de fin n'est pas défini par défaut. Les délimiteurs de début et de fin peuvent (mais n'ont pas besoin) être différents.

Paramètres

Article	Descriptif
Fichier	Indique les fichiers texte en langue anglaise troff qui doivent être prétraités par la commande cw pour produire des caractères de largeur constante dans le fichier de sortie.
Fichier	Indique les fichiers texte en anglais troff qui doivent être prétraités par la commande checkcw pour vérifier les délimiteurs de début et de fin ainsi que .CW et .Equilibre de paire CN .