unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
From: Christer Enfors <christer.enfors@gmail.com>
To: emacs-erc@gnu.org, bug-gnu-emacs@gnu.org
Subject: Suggested addition to ERC documentation
Date: Sat, 4 Dec 2021 22:18:29 +0100	[thread overview]
Message-ID: <CADstuSpUMwCfxwC-q0zRw2MkH1r6wH-BzRO=4m=Bh-GcT6LOng@mail.gmail.com> (raw)


[-- Attachment #1.1: Type: text/plain, Size: 221 bytes --]

I've written a brief addition to the Introduction section of the ERC
documentation (attached). This is my first time trying to make a
contribution to Emacs, so apologies if I'm doing something wrong.

-- 
Christer Enfors

[-- Attachment #1.2: Type: text/html, Size: 473 bytes --]

[-- Attachment #2: 0001-Add-IRC-introduction.patch --]
[-- Type: text/x-patch, Size: 2403 bytes --]

From ea5c87d750cf44a5a57a7415746530896543cc21 Mon Sep 17 00:00:00 2001
From: Christer Enfors <christer.enfors@gmail.com>
Date: Sat, 4 Dec 2021 22:13:13 +0100
Subject: [PATCH] Add IRC introduction

---
 doc/misc/erc.texi | 28 +++++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/doc/misc/erc.texi b/doc/misc/erc.texi
index 49ad795c32..6631d8420f 100644
--- a/doc/misc/erc.texi
+++ b/doc/misc/erc.texi
@@ -87,6 +87,28 @@ Top
 @node Introduction
 @chapter Introduction
 
+IRC is short for Internet Relay Chat.  When using IRC, you can
+communicate with other users on the same IRC network.  There are
+several of these networks available---if you search for ``IRC
+networks'' in your favorite search engine, you are likely to find
+up-to-date lists of IRC networks catering to various interests and
+topics.
+
+In order to use IRC, you need an IRC client such as ERC.  Using the
+client, you connect to an IRC server.  Once you've done that, you will
+have access to all available channels on that server's network.  A
+channel is basically a chat room, and what you type in a channel will
+be shown to all other users in that channel, and you can be in several
+channels at the same time---most clients will show each channel in its
+own window.  IRC channel names always begin with a @samp{#} character.
+For example, the Emacs channel on Libera.Chat is @samp{#emacs}, and
+the ERC channel is @samp{#erc}.  Do not confuse them with the hashtags
+used on many social media platforms.
+
+It is also possible to send private messages to other IRC
+users on the same network, regardless of whether or not they are in
+the same channel as you.
+
 ERC is a powerful, modular, and extensible IRC client for Emacs.
 It is distributed with Emacs since version 22.1.
 
@@ -114,7 +136,11 @@ Getting Started
 @cindex settings
 
 The command @kbd{M-x erc} will start ERC and prompt for the server to
-connect to.
+connect to.  If you're unsure of which server or network to connect
+to, we suggest you start with ``irc.libera.chat''.  There you will
+find the @samp{#emacs} channels where you can chat with other Emacs
+and users, and if you're having trouble with ERC, you can join the
+@samp{#erc} channel and ask for help there.
 
 If you want to place ERC settings in their own file, you can place them
 in @file{~/.emacs.d/.ercrc.el}, creating it if necessary.
-- 
2.25.1


             reply	other threads:[~2021-12-04 21:18 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-12-04 21:18 Christer Enfors [this message]
2021-12-04 21:45 ` Suggested addition to ERC documentation Emanuel Berg via General discussion about ERC
2021-12-05  1:44 ` bug#52287: " Lars Ingebrigtsen

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to='CADstuSpUMwCfxwC-q0zRw2MkH1r6wH-BzRO=4m=Bh-GcT6LOng@mail.gmail.com' \
    --to=christer.enfors@gmail.com \
    --cc=bug-gnu-emacs@gnu.org \
    --cc=emacs-erc@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).