comparison doc/misc/erc.texi @ 88015:7b54e553ca0b

Sync ERC 5.3 release.

88014:e830695cdb7f

@end direntry

@syncodeindex fn cp

@copying
This manual is for ERC version 5.2.

Copyright @copyright{} 2005, 2006, 2007, 2008 Free Software Foundation, Inc.

@quotation
Permission is granted to copy, distribute and/or modify this document

* History::                     The history of ERC.
* Copying::                     The GNU General Public License gives you
                                  permission to redistribute ERC on
                                  certain terms; it also explains that
                                  there is no warranty.
* GNU Free Documentation License:: The license for this documentation.
* Concept Index::               Search for terms.

@detailmenu
 --- The Detailed Node Listing ---

Note that some ERC files are not included with Emacs due to copyright or
dependency issues.  If desired, they may be found at the following
locations, or from your local GNU mirror.

@itemize @bullet
@item @uref{http://ftp.gnu.org/gnu/erc/erc-5.2-extras.tar.gz}
@item @uref{http://ftp.gnu.org/gnu/erc/erc-5.2-extras.zip}
@end itemize

The rest of this chapter may be skipped if you are using the version of
ERC that comes with Emacs.

@cindex development

Choose the development version if you want to live on the bleeding edge
of ERC development or try out new features before release.

@subheading GNU Arch

ERC is developed using GNU Arch.  Downloading ERC with Arch and staying
up-to-date involves the following steps.

@enumerate
@cindex GNU Arch, installing
@item Install arch

@itemize @bullet
@item Debian: @kbd{apt-get install tla}.
@item Other distributions: see @uref{ftp://ftp.gnu.org/gnu/gnu-arch/}.
@end itemize

@cindex GNU Arch, downloading ERC
@item Register the archive.
@example
tla register-archive -f http://arch.sv.gnu.org/archives/erc/erc
@end example

@item Download the ERC source code.
@example
# Download ERC into the @file{erc} directory.
tla get erc@@sv.gnu.org/erc--main--0 erc
@end example

@item List upstream changes that are missing from your local copy.
Do this whenever you want to see whether new changes have been committed
to ERC.

@example
# Change to the source directory you are interested in.
cd erc/

# Display the summary of changes
tla missing --summary
@end example

@cindex GNU Arch, updating ERC
@item Update to the latest version by replaying missing changes.
@example
cd erc
tla update
@end example

@end enumerate

If you are new to Arch and want to learn more about developing ERC with
it, visit @uref{http://emacswiki.org/cgi-bin/wiki/ErcDevelopment} for
full instructions.

@subheading Development snapshots

@cindex development snapshot
Alternatively, the latest development snapshot may be downloaded in both
``.tar.gz'' and ``.zip'' forms.

@itemize @bullet
@item @uref{http://www.mwolson.org/static/dist/erc-latest.tar.gz}
@item @uref{http://www.mwolson.org/static/dist/erc-latest.zip}
@end itemize


@node Installation, Getting Started, Obtaining ERC, Top
@comment  node-name,  next,  previous,  up
@chapter Installation

ERC became an official GNU project, and development moved to
@uref{http://sv.gnu.org/projects/erc}.  We switched to using GNU Arch as
our revision control system.  Our mailing list address changed as well.

@end itemize

@node Copying, GNU Free Documentation License, History, Top
@comment  node-name,  next,  previous,  up
@include gpl.texi

88015:7b54e553ca0b

@end direntry

@syncodeindex fn cp

@copying
This manual is for ERC version 5.3.

Copyright @copyright{} 2005, 2006, 2007, 2008 Free Software Foundation, Inc.

@quotation
Permission is granted to copy, distribute and/or modify this document

* History::                     The history of ERC.
* Copying::                     The GNU General Public License gives you
                                  permission to redistribute ERC on
                                  certain terms; it also explains that
                                  there is no warranty.
* GNU Free Documentation License::  The license for this documentation.
* Concept Index::               Search for terms.

@detailmenu
 --- The Detailed Node Listing ---

Note that some ERC files are not included with Emacs due to copyright or
dependency issues.  If desired, they may be found at the following
locations, or from your local GNU mirror.

@itemize @bullet
@item @uref{http://ftp.gnu.org/gnu/erc/erc-5.3-extras.tar.gz}
@item @uref{http://ftp.gnu.org/gnu/erc/erc-5.3-extras.zip}
@end itemize

The rest of this chapter may be skipped if you are using the version of
ERC that comes with Emacs.

@cindex development

Choose the development version if you want to live on the bleeding edge
of ERC development or try out new features before release.

@cindex git version control system, using
The git version control system allows you to keep up-to-date with the
latest changes to the development version of ERC.  It also allows you
to contribute changes (via commits, if you are have developer access to
the repository, or via patches, otherwise).  If you would like to
contribute to ERC development, it is highly recommended that you use
git.

If you are new to git, you might find this tutorial helpful:
@uref{http://www.kernel.org/pub/software/scm/git/docs/tutorial.html}.

Downloading ERC with git and staying up-to-date involves the following
steps.

@enumerate
@item Install git.

@itemize @bullet
@item Debian and Ubuntu: @kbd{apt-get install git-core}.
@item Windows: @uref{http://git.or.cz/gitwiki/WindowsInstall}.
@item Other operating systems: download, compile, and install the source
from @uref{http://www.kernel.org/pub/software/scm/git/}, or find a git
package for your operating system.
@end itemize

@item Download the ERC development branch.

If you have developer access to ERC, do:

@example
git clone ssh://loginname@@git.sv.gnu.org/srv/git/erc.git
@end example

otherwise, do:

@example
git clone git://git.sv.gnu.org/erc.git
@end example

If you are behind a restrictive firewall, and do not have developer
access, then do the following instead:

@example
git clone http://git.sv.gnu.org/r/erc.git
@end example

@item List upstream changes that are missing from your local copy.
Do this whenever you want to see whether new changes have been committed
to ERC.  If you wish, you may skip this step and proceed directly to
the ``update'' step.

@example
# Change to the source directory you are interested in.
cd erc

# Fetch new changes from the repository, but don't apply them yet
git fetch origin

# Display log messages for the new changes
git log HEAD..origin
@end example

``origin'' is git's name for the location where you originally got ERC
from.  You can change this location at any time by editing the
@file{.git/config} file in the directory where the ERC source was
placed.

@cindex updating ERC with git
@item Update to the latest version by pulling in any missing changes.

@example
cd erc
git pull origin
@end example

git will show how many files changed, and will provide a visual display
for how many lines were changed in each file.

@end enumerate

There are other ways to interact with the ERC repository.

@itemize
@item Browse git repo: @uref{http://git.sv.gnu.org/gitweb/?p=erc.git}
@item Latest development snapshot: @uref{http://mwolson.org/static/dist/erc-latest.tar.gz}
@item Latest development snapshot (zip file): @uref{http://mwolson.org/static/dist/erc-latest.zip}
@end itemize

The latest development snapshot can lag behind the git repo by as much
as 20 minutes, but never more than that.

For further information on committing changes to ERC and performing
development, please consult
@uref{http://emacswiki.org/cgi-bin/wiki/ErcDevelopment}.


@node Installation, Getting Started, Obtaining ERC, Top
@comment  node-name,  next,  previous,  up
@chapter Installation

ERC became an official GNU project, and development moved to
@uref{http://sv.gnu.org/projects/erc}.  We switched to using GNU Arch as
our revision control system.  Our mailing list address changed as well.

@item 2007

We switched to using git for our version control system.

@end itemize

@node Copying, GNU Free Documentation License, History, Top
@comment  node-name,  next,  previous,  up
@include gpl.texi