| 1 |
graaff 08/05/10 09:29:24 |
| 2 |
|
| 3 |
Modified: xemacs.xml |
| 4 |
Log: |
| 5 |
Update the xemacs documentation: introduce xemacs-packages-all and the |
| 6 |
status of xemacs-packages-sumo; point people to the xemacs overlay for |
| 7 |
XEmacs 21.5 ebuilds. |
| 8 |
|
| 9 |
Revision Changes Path |
| 10 |
1.4 xml/htdocs/proj/en/lisp/emacs/xemacs.xml |
| 11 |
|
| 12 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/lisp/emacs/xemacs.xml?rev=1.4&view=markup |
| 13 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/lisp/emacs/xemacs.xml?rev=1.4&content-type=text/plain |
| 14 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/lisp/emacs/xemacs.xml?r1=1.3&r2=1.4 |
| 15 |
|
| 16 |
Index: xemacs.xml |
| 17 |
=================================================================== |
| 18 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/lisp/emacs/xemacs.xml,v |
| 19 |
retrieving revision 1.3 |
| 20 |
retrieving revision 1.4 |
| 21 |
diff -u -r1.3 -r1.4 |
| 22 |
--- xemacs.xml 20 Aug 2007 00:05:36 -0000 1.3 |
| 23 |
+++ xemacs.xml 10 May 2008 09:29:24 -0000 1.4 |
| 24 |
@@ -1,6 +1,6 @@ |
| 25 |
<?xml version='1.0' encoding="UTF-8"?> |
| 26 |
|
| 27 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/lisp/emacs/xemacs.xml,v 1.3 2007/08/20 00:05:36 nightmorph Exp $ --> |
| 28 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/lisp/emacs/xemacs.xml,v 1.4 2008/05/10 09:29:24 graaff Exp $ --> |
| 29 |
|
| 30 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 31 |
|
| 32 |
@@ -20,8 +20,8 @@ |
| 33 |
<!-- See http://creativecommons.org/licenses/by-sa/2.0 --> |
| 34 |
<license/> |
| 35 |
|
| 36 |
-<version>0.1</version> |
| 37 |
-<date>2007-01-04</date> |
| 38 |
+<version>1.0</version> |
| 39 |
+<date>2008-05-10</date> |
| 40 |
|
| 41 |
<chapter> |
| 42 |
<title>Introduction</title> |
| 43 |
@@ -52,10 +52,28 @@ |
| 44 |
XEmacs-specific packages of applications that are also otherwise |
| 45 |
distributed. The packaged versions are known to work with XEmacs and |
| 46 |
may contains XEmacs-specific enhancements. In a normal XEmacs |
| 47 |
-installation these packages can be installed using the package |
| 48 |
-manager. In Gentoo the packages are provided as ebuilds, making |
| 49 |
-updating and maintenance easier. You can find the list of all packages |
| 50 |
-in the <c>app-xemacs/*</c> category. |
| 51 |
+installation these packages can be installed using the built-in XEmacs |
| 52 |
+package manager. In Gentoo the packages are provided as ebuilds, |
| 53 |
+making updating and maintenance easier. An added benefit is that the |
| 54 |
+<c>xemacs</c> USE flag can be used to pull in relevant XEmacs |
| 55 |
+packages. For example, when emerging <c>ruby</c> with the |
| 56 |
+<c>xemacs</c> USE flag you will also emerge the |
| 57 |
+<c>app-xemacs/ruby-modes</c> packages, enabling ruby support in |
| 58 |
+XEmacs. You can find the list of all packages in the |
| 59 |
+<c>app-xemacs/*</c> category. |
| 60 |
+</p> |
| 61 |
+ |
| 62 |
+<p> |
| 63 |
+You may find it cumbersome to install each XEmacs package |
| 64 |
+individually. The upstream solution to that is the distribution of the |
| 65 |
+SUMO archive, which contains all packages in a single archive. Gentoo |
| 66 |
+takes a different approach. You can emerge |
| 67 |
+<c>app-xemacs/xemacs-packages-all</c> to install all the XEmacs |
| 68 |
+packages that are also distributed in the SUMO archive. This installs |
| 69 |
+all the individual packages. Using the now-obsolete |
| 70 |
+<c>app-xemacs/xemacs-packages-sumo</c> is deprecated, and last rites |
| 71 |
+will be issued for it shortly. The reason for this particular approach |
| 72 |
+is described in <uri>https://bugs.gentoo.org/23949</uri>. |
| 73 |
</p> |
| 74 |
|
| 75 |
<p> |
| 76 |
@@ -72,36 +90,6 @@ |
| 77 |
|
| 78 |
<chapter> |
| 79 |
<title>Future plans</title> |
| 80 |
-<section> |
| 81 |
-<title>Sumo packages</title> |
| 82 |
-<body> |
| 83 |
- |
| 84 |
-<p> |
| 85 |
-<uri link="http://www.xemacs.org/">XEmacs</uri> provides a large |
| 86 |
-number of packages with lisp code specifically made compatible with |
| 87 |
-XEmacs. These packages can be found in the <c>app-xemacs/*</c> |
| 88 |
-category in portage. In addition to distributing these packages as |
| 89 |
-individual archives, XEmacs also distributes two large archives with |
| 90 |
-all packages included, called the sumo packages. In portage both these |
| 91 |
-archives can be installed using the |
| 92 |
-<c>app-xemacs/xemacs-packages-sumo</c> ebuild. |
| 93 |
-</p> |
| 94 |
- |
| 95 |
-<p> |
| 96 |
-This approach results in two ways to provide the same set of |
| 97 |
-packages and files. As <uri>https://bugs.gentoo.org/23949</uri> |
| 98 |
-mentions the sumo package and the other packages should really block |
| 99 |
-each other. A better solution would be to remove the sumo package |
| 100 |
-completely and instead create a meta package which would pull in all |
| 101 |
-the other packages as dependencies. This would have the same net |
| 102 |
-effect as the original sumo package of having a single package to |
| 103 |
-install all lisp code, but would avoid the problems with blocking and |
| 104 |
-overwriting files. Work is currently underway to provide such a |
| 105 |
-package. Until that time the sumo package will be updated as usual. |
| 106 |
-</p> |
| 107 |
- |
| 108 |
-</body> |
| 109 |
-</section> |
| 110 |
|
| 111 |
<section> |
| 112 |
<title>XEmacs 21.5</title> |
| 113 |
@@ -110,12 +98,20 @@ |
| 114 |
<p> |
| 115 |
Upstream development is currently focused on XEmacs 21.5, but this |
| 116 |
version is currently not yet stable enough for release or day-to-day |
| 117 |
-use. It is planned to add XEmacs 21.5 to Gentoo portage, but it will |
| 118 |
-be package.masked until upstream is ready to release beta-quality |
| 119 |
-versions. It is not yet clear when XEmacs 21.5 will be added to |
| 120 |
-portage, although some work has already been done. |
| 121 |
+use. Unfortunately only the 21.5 versions provide proper support for |
| 122 |
+UTF-8, which is becoming more and more a requirement, so we expect to |
| 123 |
+add a 21.5 release to the main tree.</p> |
| 124 |
+ |
| 125 |
+<p> |
| 126 |
+Until that time experimental XEmacs 21.5 ebuilds are available from |
| 127 |
+the official xemacs overlay. You can add this overlay to your system |
| 128 |
+using layman. |
| 129 |
</p> |
| 130 |
|
| 131 |
+<pre caption="Adding the XEmacs overlay"> |
| 132 |
+# <i>layman -a xemacs</i> |
| 133 |
+</pre> |
| 134 |
+ |
| 135 |
</body> |
| 136 |
</section> |
| 137 |
</chapter> |
| 138 |
@@ -141,7 +137,7 @@ |
| 139 |
|
| 140 |
<p>The app-xemacs/* ebuilds in portage are kept up-to-date with the |
| 141 |
released set of packages using a python script called <uri |
| 142 |
-link="pebuild.gz">pebuild</uri> written by Mats Lidell.</p> |
| 143 |
+link="pebuild.gz">pebuild</uri> originally written by Mats Lidell.</p> |
| 144 |
|
| 145 |
</body> |
| 146 |
</section> |
| 147 |
|
| 148 |
|
| 149 |
|
| 150 |
-- |
| 151 |
gentoo-commits@l.g.o mailing list |
Archives