* [gentoo-commits] gentoo commit in xml/htdocs/proj/en/lisp/emacs: xemacs.xml
@ 2008-05-10 9:29 Hans de Graaff (graaff)
0 siblings, 0 replies; only message in thread
From: Hans de Graaff (graaff) @ 2008-05-10 9:29 UTC (permalink / raw
To: gentoo-commits
graaff 08/05/10 09:29:24
Modified: xemacs.xml
Log:
Update the xemacs documentation: introduce xemacs-packages-all and the
status of xemacs-packages-sumo; point people to the xemacs overlay for
XEmacs 21.5 ebuilds.
Revision Changes Path
1.4 xml/htdocs/proj/en/lisp/emacs/xemacs.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/lisp/emacs/xemacs.xml?rev=1.4&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/lisp/emacs/xemacs.xml?rev=1.4&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/lisp/emacs/xemacs.xml?r1=1.3&r2=1.4
Index: xemacs.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/lisp/emacs/xemacs.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- xemacs.xml 20 Aug 2007 00:05:36 -0000 1.3
+++ xemacs.xml 10 May 2008 09:29:24 -0000 1.4
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/lisp/emacs/xemacs.xml,v 1.3 2007/08/20 00:05:36 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/lisp/emacs/xemacs.xml,v 1.4 2008/05/10 09:29:24 graaff Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
@@ -20,8 +20,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>0.1</version>
-<date>2007-01-04</date>
+<version>1.0</version>
+<date>2008-05-10</date>
<chapter>
<title>Introduction</title>
@@ -52,10 +52,28 @@
XEmacs-specific packages of applications that are also otherwise
distributed. The packaged versions are known to work with XEmacs and
may contains XEmacs-specific enhancements. In a normal XEmacs
-installation these packages can be installed using the package
-manager. In Gentoo the packages are provided as ebuilds, making
-updating and maintenance easier. You can find the list of all packages
-in the <c>app-xemacs/*</c> category.
+installation these packages can be installed using the built-in XEmacs
+package manager. In Gentoo the packages are provided as ebuilds,
+making updating and maintenance easier. An added benefit is that the
+<c>xemacs</c> USE flag can be used to pull in relevant XEmacs
+packages. For example, when emerging <c>ruby</c> with the
+<c>xemacs</c> USE flag you will also emerge the
+<c>app-xemacs/ruby-modes</c> packages, enabling ruby support in
+XEmacs. You can find the list of all packages in the
+<c>app-xemacs/*</c> category.
+</p>
+
+<p>
+You may find it cumbersome to install each XEmacs package
+individually. The upstream solution to that is the distribution of the
+SUMO archive, which contains all packages in a single archive. Gentoo
+takes a different approach. You can emerge
+<c>app-xemacs/xemacs-packages-all</c> to install all the XEmacs
+packages that are also distributed in the SUMO archive. This installs
+all the individual packages. Using the now-obsolete
+<c>app-xemacs/xemacs-packages-sumo</c> is deprecated, and last rites
+will be issued for it shortly. The reason for this particular approach
+is described in <uri>https://bugs.gentoo.org/23949</uri>.
</p>
<p>
@@ -72,36 +90,6 @@
<chapter>
<title>Future plans</title>
-<section>
-<title>Sumo packages</title>
-<body>
-
-<p>
-<uri link="http://www.xemacs.org/">XEmacs</uri> provides a large
-number of packages with lisp code specifically made compatible with
-XEmacs. These packages can be found in the <c>app-xemacs/*</c>
-category in portage. In addition to distributing these packages as
-individual archives, XEmacs also distributes two large archives with
-all packages included, called the sumo packages. In portage both these
-archives can be installed using the
-<c>app-xemacs/xemacs-packages-sumo</c> ebuild.
-</p>
-
-<p>
-This approach results in two ways to provide the same set of
-packages and files. As <uri>https://bugs.gentoo.org/23949</uri>
-mentions the sumo package and the other packages should really block
-each other. A better solution would be to remove the sumo package
-completely and instead create a meta package which would pull in all
-the other packages as dependencies. This would have the same net
-effect as the original sumo package of having a single package to
-install all lisp code, but would avoid the problems with blocking and
-overwriting files. Work is currently underway to provide such a
-package. Until that time the sumo package will be updated as usual.
-</p>
-
-</body>
-</section>
<section>
<title>XEmacs 21.5</title>
@@ -110,12 +98,20 @@
<p>
Upstream development is currently focused on XEmacs 21.5, but this
version is currently not yet stable enough for release or day-to-day
-use. It is planned to add XEmacs 21.5 to Gentoo portage, but it will
-be package.masked until upstream is ready to release beta-quality
-versions. It is not yet clear when XEmacs 21.5 will be added to
-portage, although some work has already been done.
+use. Unfortunately only the 21.5 versions provide proper support for
+UTF-8, which is becoming more and more a requirement, so we expect to
+add a 21.5 release to the main tree.</p>
+
+<p>
+Until that time experimental XEmacs 21.5 ebuilds are available from
+the official xemacs overlay. You can add this overlay to your system
+using layman.
</p>
+<pre caption="Adding the XEmacs overlay">
+# <i>layman -a xemacs</i>
+</pre>
+
</body>
</section>
</chapter>
@@ -141,7 +137,7 @@
<p>The app-xemacs/* ebuilds in portage are kept up-to-date with the
released set of packages using a python script called <uri
-link="pebuild.gz">pebuild</uri> written by Mats Lidell.</p>
+link="pebuild.gz">pebuild</uri> originally written by Mats Lidell.</p>
</body>
</section>
--
gentoo-commits@lists.gentoo.org mailing list
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2008-05-10 9:29 UTC | newest]
Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2008-05-10 9:29 [gentoo-commits] gentoo commit in xml/htdocs/proj/en/lisp/emacs: xemacs.xml Hans de Graaff (graaff)
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox