3. Option de la ligne de commande et variables d'environnement

Cette dection décrit les options de ligne de commande disponibles et liste les variables d'environnement qui influencent slrn.

Note: S'il vous plait n'utilisez pas les options qui sont notées ``obsolete'' dans ce manuel. Elles ne sont inclusent que pour une compatibilité avec les versions précédentes et seront éliminée avant le lancement de la version 1.0 .

3.1 Options de la ligne de commande

Les options suivantes peuvent être utilisées lors de l'appel de slrn depuis la ligne de commande:

-a

Read active file when checking for new news. This can be permanently turned on by setting read_active to 1.

-C

Utilise les couleurs sans vérifier si le terminal les supporte.

-C-

N'utilise pas les couleurs, même si le terminal les supporte.

-d

Get group descriptions (taglines) from the news server. Veuillez noter que cela peut causer le téléchargement de plusieurs centaines de kilo-octets et donc prendre du temps. La sortie est enregistrée dans un fichier local, donc il vous suffit de le faire une fois. Ne doit pas être utilisé en combinaison avec ``--create''.

-Dnom

Ajoute nom à la liste des predefined preprocessing tokens, which can be used in your slrnrc file to have conditionally interpreted lines. Par exemple, vous pouvez utiliser l'entrée suivante dans votre slrnc si vous voulez lire les listes de diffusion (stockée comme des répertoires de courrier -MH mail directories- dans /home/username/Mail/) avec slrn -DMAIL:

#ifdef MAIL
  set spool_inn_root      "/home/username/Mail"
  set spool_root          "/home/username/Mail"
  set spool_nov_root      "/home/username/Mail"
  set server_object       "spool"
  set read_active         1
  server "/home/username/Mail"  ".jnewsrc.mail"
#endif

Similarly, you can test if a given environment variable is set:

#if$DISPLAY
  set editor_command "xjed '%s' -g %d -tmp"
#endif

-f fichier

Utilise fichier comme fichier newsrc pour cette session. Il est possible d'utiliser la commande de configuration server

-h [snews://]host[:port]

Connection au serveur NNTP host, en ne tenant pas compte de la variable d'environnement $NNTPSERVER. Si aucun port n'est donné, le port par defaut pour NNTP (119) sera utilisé. Le prefixe snews:// indique que slrn doit essayer d'établir une connexion securisée. Cela peut résulter par un erreur quand le suppor pour SSL n'est pas compilé. . Like -p, this option is only accepted after --nntp or when NNTP is the default mode.

-i fichier

Lit fichier comme fichier d'initialisation (slrnrc). Le fichier par défaut est .slrnrc (ou slrn.rc sur VMS, OS/2 et Windows) dans votre home directory.

-k

Ne lit pas le fichier score.

-k0

Read the score file, but inhibit ``expensive'' scoring. A scoring rule is ``expensive'' if it contains header lines that are not included in the server's overview files. This makes applying them slow.

-n

Ne vérifie pas la présence de nouveau groupes (ce qui se solde par un démarrage plus rapide ). Il est possible de configurer ceci en utilisant check_new_groups.

-m

Force le support pour la souris (sans vérifier si cela fonctionne avec le terminal utilisé). Pour activer de manière permanent le support de la souris, vous pouvez utiliser la variable de configuration mouse.

-p N

Utilise le port N pour se connecter au serveur NNTP.

-w

Wait for a key before switching to full screen mode. This is useful if you want to read the startup messages.

--create

Read the active file (the list of all groups) from the news server to create an initial newsrc file.

-create

Version obsolete de ``--create''

--debug fichier

Write debugging output to fichier. In NNTP mode, this logs the dialog with the server; the spool backend currently only uses this for error messages.

--help

Montre de l'aide pour les options de la ligne de commande.

--inews

Use an external inews program to post articles.

--kill-log file

Keep a log of all articles that were killed by the scorefile in file.

--nntp

Use builtin NNTP support for reading and posting (an external program is used to post if the ``force inews'' compile time option is set).

--pull

Spool outgoing articles locally for slrnpull to send.

--spool

Read directly from spool.

--version

Affiche la version et quelques autres renseignements.

3.2 Variables d'environnement

COLORTERM

Si cette variable est mise, slrn supposera que votre terminal supporte les sequences ANSI pour les couleurs. It also enables a workaround for a problem with the mouse reporting when running slrn inside of an rxvt.

DISPLAY

Si renseigné, slrn supposera que X11 est lancé et utilisera Xbrowser pour visualiser une URL. Sinon, non_Xbrowser est utilisé.

EDITOR

Voir $SLRN_EDITOR.

HOME

Voir $SLRNHOME.

HOSTNAME

If no hostname is given, the value of this environment variable is used. As a last resort, slrn will call gethostname(3) and gethostbyname(3) to find a value it can work with. The hostname can also be hardcoded when building slrn (see OUR_HOSTNAME in slrnfeat.h). The value of OUR_HOSTNAME can either be the hostname as a string or the name of a file containing the hostname. Note that the environment variable overrides the hardcoded default and that the configuration variable overrides both.

LOGNAME

voir $USER.

NAME

If you did not set realname, slrn tries to get a value from $NAME. On Unix systems, it also queries the /etc/passwd gecos field.

NNTPSERVER

You can use this variable to tell slrn which NNTP server to connect to. It can be overridden by the command line option -h. It is possible to compile in a default setting in case the user does not set $NNTPSERVER. This is done in slrnfeat.h by either setting NNTPSERVER_FILE to the name of a file containing the hostname or by directly setting NNTPSERVER_NAME to the hostname. In case both are defined, slrn first tries to read the file and only uses NNTPSERVER_NAME as a fallback.

ORGANIZATION

If organization is unset, the value of this variable is used. It overrides the compile time setting of OUR_ORGANIZATION (default is unset) in slrnfeat.h. Both the environment variable and the compile time default can optionally point to a file from which the organization line will be read.

PRINTER

Sur les systèmes Unix, slrn redirige le message courant vers un programe esterne dans le but de l'imprimer. Si vous ne spécifiez pas le programme utilisant printer_name, il utilisera lpr -P$PRINTER per défaut.

PWD

Cette varible n'est utilisée que sur les systèmes Unix qui ne supportent pas getcwd(3). In these cases, it should be set to the current directory at the time slrn is invoked. This is usually nothing the user has to worry about.

REPLYTO

La valeur de cette variable est utilisée par défaut si vous n'avez pas renseigné replyto dans votre fichier slrnrc.

SLANG_EDITOR

Voir $SLRN_EDITOR.

SLRNHELP

The help window you get when hitting `?' inside slrn shows the default key bindings, which may or may not be the ones you are currently using. This is why slrn allows you to change the help text by creating a ``help file'' and letting $SLRNHELP point to it (the absolute filename is needed here). If $SLRNHELP is unset, slrn tries to read help.txt in the config directory.

Your slrn distribution should include the file help.txt which you can copy and modify to suit your needs. It also serves as an example of the syntax of slrn help files.

SLRNHOME

When interpreting filenames as relative to your home directory, slrn uses this variable to find out what your home directory is. If $SLRNHOME is unset, $HOME is used instead.

SLRNPULL_ROOT

If you want to use slrnpull, you need to define a directory where it will look for its configuration files and spool the articles. An absolute filename is needed here. There is a compile time default for it in slrnfeat.h (SLRNPULL_ROOT_DIR, default: "/var/spool/news/slrnpull"), which can be overridden by the environment variable $SLRNPULL_ROOT. If an alternate root directory is given via the command line parameter -d, it overrides both.

SLRN_EDITOR

If you did not define an editor in editor_command et al, slrn checks this variable. If it is unset, slrn subsequently looks at $SLANG_EDITOR, $EDITOR and $VISUAL. The last desperate call goes to edit (VMS and Windows), e (OS/2) or vi (Unix).

SLRN_LIB_DIR

Cette variable est obsolete.

TMP

Indicates the directory in which slrn should save temporary files. If it is unset or does not contain an existing directory, $TMPDIR is tried. If both are unset, /tmp is used on UNIX systems, the current working directory on OS/2 and Windows and SYS$LOGIN: on VMS.

An exception to this are temporary files created to invoke metamail. In this case, $TMP is only queried on OS/2 and Windows NT.

TMPDIR

Voir $TMP.

USER

If username is unset, slrn tries to get your login name from the system first. If this fails, it looks at $USER and $LOGNAME.

VISUAL

Voir $SLRN_EDITOR.