Conversion de la page sur IRC.
This commit is contained in:
george
parent
2d4c004552
commit
75884057d4
4 changed files with 394 additions and 1 deletions
1
00TODO
1
00TODO
|
|
@ -135,7 +135,6 @@ internet/html/quoi.html
|
||||||
internet/html/selec.backgr.html
|
internet/html/selec.backgr.html
|
||||||
internet/html/structurer.html
|
internet/html/structurer.html
|
||||||
internet/index.html
|
internet/index.html
|
||||||
internet/irc.html
|
|
||||||
internet/lynx.html
|
internet/lynx.html
|
||||||
internet/mail-mutt.html
|
internet/mail-mutt.html
|
||||||
internet/mail-pine.html
|
internet/mail-pine.html
|
||||||
|
|
|
||||||
394
internet/irc.tml
Normal file
394
internet/irc.tml
Normal file
|
|
@ -0,0 +1,394 @@
|
||||||
|
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||||||
|
<!DOCTYPE html
|
||||||
|
PUBLIC "-//ENS/Tuteurs//DTD TML 1//EN"
|
||||||
|
"tuteurs://DTD/tml.dtd">
|
||||||
|
<html>
|
||||||
|
<head>
|
||||||
|
<title>IRC</title>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
|
||||||
|
<h1>IRC (Internet Relay Chat)</h1>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
IRC (de l'anglais <em>Internet Relay Chat</em>, qui se traduirait en
|
||||||
|
«Discussion Relayée sur Internet») est un système de messagerie en temps réel
|
||||||
|
sur Internet. Des dizaines de milliers d'utilisateurs partout dans le monde y
|
||||||
|
sont connectés à tout moment, occupés à discuter dans des groupes qu'on
|
||||||
|
appelle des <em>channels</em>.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
|
||||||
|
<h2><a name="quoi">Qu'est-ce que IRC ?</a></h2>
|
||||||
|
|
||||||
|
<h3><a name="discussions">Type de discussions</a></h3>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
IRC est un service de messages sur Internet. Sa principale différence avec
|
||||||
|
des services comme le
|
||||||
|
<a href="courrier/">courier électronique</a> ou <a href="news.html">les news
|
||||||
|
de Usenet</a> est que les conversations sur IRC se déroulent en temps
|
||||||
|
réel. Vous envoyez un message, quelqu'un vous répond, et ainsi de suite,
|
||||||
|
vous conversez avec d'autres utilisateurs. En ce sens, son fonctionnement
|
||||||
|
ressemble à une conférence téléphonique : les messages ne sont pas
|
||||||
|
sauvegardés après leur transmission (comme dans le
|
||||||
|
<a href="/tuteurs/cours/unix/communiquer.html#ytalk">talk</a>).
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Sur un réseau IRC (et il y en a plusieurs) il y a le plus souvent quelques
|
||||||
|
dizaines de milliers d'utilisateurs simultanés. Chacun s'identifie par un
|
||||||
|
surnom ou <em>nickname</em> ; vous choisissez votre <i>nickname</i> quand
|
||||||
|
vous vous connectez à IRC, celui-ci sera refusé (et le système vous en
|
||||||
|
demandera un autre) si quelqu'un d'autre est déjà en train d'utiliser le
|
||||||
|
même.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Les conversations sur IRC se déroulent dans des groupes nommés
|
||||||
|
<em>channels</em>, le principe étant que, quand vous rentrez dans un channel,
|
||||||
|
vous voyez la discussion qui y a lieu, et vous pouvez y participer. Il est
|
||||||
|
également possible d'envoyer des messages privés à destination d'un autre
|
||||||
|
utilisateur, indépendamment de tout channel.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h3><a name="serveurs">Les réseaux et les serveurs IRC</a></h3>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Il existe plusieurs réseaux IRC indépendants; chaque réseau se compose d'un
|
||||||
|
certain nombre de serveurs connectés entre eux. Les nicknames et les channels
|
||||||
|
sont globaux sur chaque réseau : vous n'avez pas besoin d'être connectés
|
||||||
|
au même serveur IRC pour discuter avec quelqu'un, il vous faut juste être sur
|
||||||
|
le même réseau.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Les quatre réseaux IRC principaux sont :
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<dl>
|
||||||
|
<dt>IRCnet</dt><dd>le réseau principal Européen ;</dd>
|
||||||
|
<dt>EFnet</dt><dd>le réseau principal Américain ;</dd>
|
||||||
|
<dt>Undernet</dt><dd>un réseau alternatif ;</dd>
|
||||||
|
<dt>DALnet</dt><dd>un autre réseau alternatif.</dd>
|
||||||
|
</dl>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
À l'École, pour différentes considérations de sécurité, l'accès à la
|
||||||
|
plupart des réseaux IRC est bloqué. En revanche, il y a un serveur interne
|
||||||
|
installé sur le quatramaran. Il n'est connecté à aucun autre serveur, et
|
||||||
|
constitue donc un réseau IRC à lui tout seul ; on n'y rencontrera donc que
|
||||||
|
des normaliens et assimilés. On peut savoir à peu près qui est connecté
|
||||||
|
dessus avec la commande <code>qui -too irc</code>.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h2><a name="utiliser">Utilisation d'IRC</a></h2>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Pour se connecter à IRC, on peut utiliser différents logiciels. Le plus
|
||||||
|
facile est probablement XChat, qui est installé sur les ordinateurs de
|
||||||
|
l'École par gourous. C'est son fonctionnement que nous détaillerons. Pour
|
||||||
|
le lancer, il suffit de taper <code>xchat</code> dans une fenêtre de
|
||||||
|
terminal, ou de sélectionner la ligne qui va bien dans le menu de
|
||||||
|
lancement, si elle existe.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Quand vous lancez XChat, deux fenêtres s'ouvrent. Celle du dessus présente
|
||||||
|
une liste de serveurs connus (par défaut, il ne connait que le serveur
|
||||||
|
interne à l'École). Elle se présente ainsi :
|
||||||
|
</p>
|
||||||
|
<div class="illustration">
|
||||||
|
<img src="irc_liste.png" alt="[Fenêtre liste de serveurs]" />
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
La partie haute concerne votre identité. En particulier, vous pouvez
|
||||||
|
indiquer votre surnom, ainsi que des solutions de rechange s'il est déjà
|
||||||
|
pris. Ensuite vient la liste des serveurs connus, qui se présente un peu
|
||||||
|
comme les <em>bookmarks</em> de netscape. Pour se connecter directement, il
|
||||||
|
suffit de cliquer sur le serveur qu'on a choisi, puis sur le bouton
|
||||||
|
«connect».
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
C'est alors la fenêtre principale qui doit maintenant avoir votre
|
||||||
|
attention. Voici un exemple de ce à quoi elle peut ressembler (après
|
||||||
|
quelques minutes de conversation) :
|
||||||
|
</p>
|
||||||
|
<div class="illustration">
|
||||||
|
<img src="irc_principale.png" alt="[Fenêtre principale]" />
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li>Tout en haut, un menu déroulant tout ce qu'il y a de plus classique
|
||||||
|
permet de faire les principales opérations.</li>
|
||||||
|
<li>En dessous, une ligne de boutons permettent de manipuler la fenêtre, et
|
||||||
|
les modes du <em>channel</em>, nous verrons à quoi tout correspond un peu
|
||||||
|
plus loin.</li>
|
||||||
|
<li>Encore en dessous se trouve la partie de l'écran où s'affiche la
|
||||||
|
discussion ; on ne peut qu'y lire.</li>
|
||||||
|
<li>À droite, il y a une liste des personnes présentes dans le
|
||||||
|
<em>channel</em>, et quelques boutons.</li>
|
||||||
|
<li>En dessous, la grande bande noire est l'endroit où on tape ses
|
||||||
|
messages.</li>
|
||||||
|
<li>Enfin, tout en bas, une série d'onglets représentent les différents
|
||||||
|
<em>channels</em> (ou assimilé).</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Au début, vous n'avez qu'un onglet, qui sert à afficher les messages venant
|
||||||
|
du serveur, qui n'ont pas de rapport avec un <em>channel</em> en
|
||||||
|
particulier. C'est à partir de cet instant que vous êtes connecté.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
La plupart des opérations s'effectue maintenant en tapant dans la barre de
|
||||||
|
message. En effet, un «message» qui commence par un <em>slash</em>
|
||||||
|
(<code>/</code>) est considéré comme une commande, un ordre donné à XChat.
|
||||||
|
Si ce que vous tapez commence par n'importe quoi d'autre, ça sera
|
||||||
|
simplement dit dans le <em>channel</em> affiché.</p>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<h3><a name="commandes">Quelques commandes utiles</a></h3>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Voici quelques commandes courantes d'IRC. Les majuscules ne sont pas
|
||||||
|
nécessaires.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<table class="tableau">
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<th><code>/HELP</code></th>
|
||||||
|
<td>demande de l'aide au programme IRC. Il vous présentera une liste
|
||||||
|
de sujets possibles. Tapez d'abord <code>/HELP 7 new_user</code>
|
||||||
|
pour avoir de l'aide générale sur IRC.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<th><code>/NICK un-surnom</code></th>
|
||||||
|
<td>vous permet de changer de surnom ; le nouveau nom sera refusé si
|
||||||
|
quelqu'un d'autre est déjà en train de l'utiliser, ou s'il est trop long
|
||||||
|
(la limite est à 9 lettres). Il ne peut pas contenir de caractère spécial
|
||||||
|
ou accentué.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<th><code>/JOIN #nom-de-channel</code></th>
|
||||||
|
<td>vous permet de rentrer dans un <i>channel</i>. Tous les noms de
|
||||||
|
<i>channel</i> commencent par le caractère <code>#</code>. Si vous
|
||||||
|
demandez à rentrer dans un channel qui n'existe pas, il sera créé
|
||||||
|
pour vous. De même, un channel disparaît au moment où son dernier
|
||||||
|
utilisateur le quitte.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<th><code>/PART #nom-de-channel</code></th>
|
||||||
|
<td>sert à quitter un <em>channel</em>. Si vous ne précisez pas de nom de
|
||||||
|
<em>channel</em>, c'est celui qui est actuellement affiché que vous
|
||||||
|
quittez.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<th><code>/MSG <i>Surnom</i> texte</code></th>
|
||||||
|
<td>envoie un message destiné uniquement à une personne ; mettez
|
||||||
|
son surnom à la place de <code>Nickname</code> sur la ligne
|
||||||
|
précédente. Si vous recevez vous-même un tel message, un nouvel onglet
|
||||||
|
s'ouvrira pour la conversation privée avec son auteur.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<th><code>/INVITE <i>Surnom</i> #channel</code></th>
|
||||||
|
<td>invite une personne dans un <em>channel</em>.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<th><code>/LIST</code></th>
|
||||||
|
<td>permet d'avoir une liste de tous les channels. Il est déconseillé
|
||||||
|
d'utiliser cette commande sur les grands serveurs, parce-que la liste
|
||||||
|
occupe des milliers de lignes et prend longtemps à arriver (aucun problème
|
||||||
|
en revanche sur le serveur interne à l'École).</td>
|
||||||
|
</tr>
|
||||||
|
</table>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Voilà pour les commandes les plus utiles. Il y en a d'autres qui,
|
||||||
|
historiquement, servaient beaucoup, mais XChat propose des boutons, c'est
|
||||||
|
plus facile à mémoriser.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Si du texte apparaît dans un onglet qui n'est pas affiché, le nom de cet
|
||||||
|
onglet s'affiche en rouge, pour attirer votre attention. Si en plus le
|
||||||
|
nouveau texte parle de vous (sur la base de votre surnom), la couleur bleue
|
||||||
|
sera utilisée.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h3><a name="faire">Que faire sur IRC</a></h3>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
En un mot : discuter. Les autres ne voient de vous que ce que vous
|
||||||
|
tapez. Ils sont aussi probablement déjà en train de parler à d'autres
|
||||||
|
personnes à la fois, n'espérez donc pas avoir leur attention complète.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Quand vous rentrez sur un <em>channel</em> public, et surtout s'il y a déjà
|
||||||
|
quelques dizaines d'utilisateurs dessus, vous verrez que le texte défile
|
||||||
|
très vite. Voici un extrait typique de la conversation sur un
|
||||||
|
channel :
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<pre>
|
||||||
|
*** Signoff: Bebile (EOF From client)
|
||||||
|
<Telemak> il y a que des CAVES ici !
|
||||||
|
*** Pilah has left channel #france
|
||||||
|
*** ombre (eymartin@sc-2.salles.entpe.fr) has joined channel #france
|
||||||
|
<steph> telemak:pardon?
|
||||||
|
<Luc> zak: oui tout pres de Frankfort
|
||||||
|
<zak2> luc: ah ok et c'est comment en allemagne
|
||||||
|
*** visiteur1 (webbar@lisbonne-story.webbar.fr) has joined channel #france
|
||||||
|
<Luc> zak: et toi ou est-tu en ce moment
|
||||||
|
<zak2> luc: paris
|
||||||
|
*** |AsSaiL| has left channel #france
|
||||||
|
*** TtouKC (oeil@toulouse2-2.hol.fr) has joined channel #france
|
||||||
|
<PEEPOO> KC: t etais ou?
|
||||||
|
<visiteur3> bonsoir
|
||||||
|
</pre>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Les leçons à en tirer sont simples mais importantes : premièrement, il
|
||||||
|
est très courant de s'addresser à quelqu'un dans un channel en commençant la
|
||||||
|
phrase par «<code>son_surnom:</code>». Ceci permet d'avoir plusieurs
|
||||||
|
conversations en cours dans un channel, et de s'y retrouver. Le corollaire de
|
||||||
|
tout cela étant que l'on apprend très vite à ne pas tenir compte des lignes
|
||||||
|
addressées à d'autres, ni des lignes qui annoncent qui rentre et qui sort du
|
||||||
|
channel.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Soyez raisonnablement poli, et ne passez pas tout votre temps à tenter de
|
||||||
|
draguer sans subtilité tout ce qui bouge : c'est la meilleure façon de se
|
||||||
|
faire <em>kicker</em> (c'est-à-dire, de vous faire éjecter du channel par un
|
||||||
|
opérateur) !
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h3><a name="modes">Les modes</a></h3>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Les channels, tout comme les utilisateurs, peuvent être dans plusieurs modes.
|
||||||
|
Chaque mode est noté par une lettre, généralement l'initiale du nom du mode en
|
||||||
|
question.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Sur les channels, les modes servent à deux choses :
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li><strong>Spécifier qui a le droit de rentrer dans le channel</strong> :
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li>Si le channel est secret (mode +s), il n'apparait pas dans la liste
|
||||||
|
donnée par <code>LIST</code>, ni dans la liste des channels renvoyées par
|
||||||
|
<code>WHOIS</code>.</li>
|
||||||
|
|
||||||
|
<li>Si le channel est <em>invite-only</em> (mode +i), seuls les utilisateurs
|
||||||
|
invités par la commande <code>/INVITE</code> ont le droit d'y rentrer.</li>
|
||||||
|
|
||||||
|
<li>Si le channel a un mot de passe (mode +k), seuls les utilisateurs qui le
|
||||||
|
connaissent ont le droit d'y rentrer.</li>
|
||||||
|
|
||||||
|
<li>Si le channel a une limite (mode +l) fixée à un certain nombre, au plus
|
||||||
|
ce nombre-là de personnes peuvent y être simultanément.</li>
|
||||||
|
|
||||||
|
<li>Chaque channel a une liste d'addresses qui sont <i>bannies</i> (mode +b).
|
||||||
|
Un utilisateur ne peut pas y rentrer si son addresse est bannie.</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li><strong>Donner le statut d'«opérateur de channel»</strong> ou
|
||||||
|
<i>chanop</i> à certains utilisateurs et pas d'autres. Un opérateur a le
|
||||||
|
droit de changer les modes globaux du channel (mettre ou enlever le mode
|
||||||
|
d'invite, mettre ou enlever une clé ou une limite, ajouter ou enlever des
|
||||||
|
<i>bans</i>, etc), et aussi de vider (en anglais, <em>kick</em>) des gens du
|
||||||
|
channel.
|
||||||
|
<br />
|
||||||
|
Quand vous créez un nouveau channel, le système vous fait opérateur, ce qui se
|
||||||
|
voit avec le @ à gauche de votre <i>nickname</i>. Quand vous rentrez dans un
|
||||||
|
channel existant, vous n'êtes pas opérateur.
|
||||||
|
<br />
|
||||||
|
Il est <strong>très mal vu</strong> de demander à être fait opérateur sur un
|
||||||
|
channel où l'on n'est pas très bien connu et apprécié. La réaction la plus
|
||||||
|
habituelle étant en fait un KICK ou même un <i>ban</i>. Faites donc
|
||||||
|
attention.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Si vous êtes opérateur sur un channel, vous pouvez changer ses modes en
|
||||||
|
utilisant les boutons en haut de l'écran (si vous n'êtes pas opérateur, ces
|
||||||
|
boutons ne vous servent qu'à connaître les modes). Voyons ces boutons (ceux
|
||||||
|
qui sont à droite de la barre blanche)
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<dl>
|
||||||
|
<dt>T</dt>
|
||||||
|
<dd>seul un opérateur peut changer le sujet du <em>channel</em></dd>
|
||||||
|
<dt>N</dt>
|
||||||
|
<dd>seules les personnes présentes dans le <em>channel</em> peuvent y
|
||||||
|
parler</dd>
|
||||||
|
<dt>S</dt>
|
||||||
|
<dd>le <em>channel</em> est secret (n'apparaît pas dans la liste)</dd>
|
||||||
|
<dt>I</dt>
|
||||||
|
<dd>le <em>channel</em> est réservé aux invités</dd>
|
||||||
|
<dt>P</dt>
|
||||||
|
<dd>le <em>channel</em> est privé<!--FIXME: ça veut dire quoi ?--></dd>
|
||||||
|
<dt>M</dt>
|
||||||
|
<dd>le <em>channel</em> est modéré (seuls les opérateurs peuvent
|
||||||
|
parler)</dd>
|
||||||
|
<dt>L <i>nombre</i></dt>
|
||||||
|
<dd>le <em>channel</em> a un nombre limité de places</dd>
|
||||||
|
<dt>K <i>mot de passe</i></dt>
|
||||||
|
<dd>le <em>channel</em> est réservé aux gens munis du mot de passe</dd>
|
||||||
|
</dl>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
On peut utiliser la commande <code>/MODE</code> pour changer le mode d'un
|
||||||
|
<em>channel</em> sans utiliser la souris. On ajoute
|
||||||
|
<code>+<i>lettre</i></code> ou <code>-<i>lettre</i></code> selon si on veut
|
||||||
|
activer ou désactiver le mode en question, et on précise éventuellement le
|
||||||
|
paramètre après.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Un channel a aussi un sujet, ou <em>topic</em> qu'on change en modifiant
|
||||||
|
dans la barre blanche en haut, ou en utilisant la commande
|
||||||
|
<code>/TOPIC</code>. Le sujet apparaît à côté du nom du <em>channel</em>
|
||||||
|
en réponse à la commande <code>/LIST</code>.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Les utilisateurs eux-mêmes peuvent aussi avoir des modes. Le seul qui soit
|
||||||
|
utile est le mode <code>+i</code> ou <i>invisible</i>. Et encore, cette
|
||||||
|
«invisibilité» est très restreinte : elle vous empêche juste d'apparaître
|
||||||
|
dans la liste donnée par une commande <code>WHO</code> à quelqu'un qui ne
|
||||||
|
serait pas dans le même channel que vous.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Vous pouvez mettre ou enlever ce mode avec les commandes <code>/UMODE
|
||||||
|
+i</code> et <code>/UMODE -i</code> respectivement.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h3>Remerciements</h3>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Cette page est initialement due à
|
||||||
|
<a href="http://www.iagora.com/~espel/index.html">Roger Espel Llima</a>,
|
||||||
|
également connu sous le surnom de APO, hacker et IRCiste émérite.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<div class="metainformation">
|
||||||
|
Auteurs : Dominique Quatravaux, Roger Espel Llima, Nicolas George.
|
||||||
|
Dernière modification le 2002-12-06.
|
||||||
|
</div>
|
||||||
|
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
BIN
internet/irc_liste.png
Normal file
BIN
internet/irc_liste.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 8 KiB |
BIN
internet/irc_principale.png
Normal file
BIN
internet/irc_principale.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 18 KiB |
Loading…
Reference in a new issue