| 1 |
flameeyes 07/12/30 15:08:37 |
| 2 |
|
| 3 |
Modified: amarok.xml |
| 4 |
Log: |
| 5 |
Update this guide too: avoid too long explanation of mongrel |
| 6 |
dependency now that the USE flag is present and it's documented in |
| 7 |
metadata.xml; add a notice that almost any xine-lib bug will reflect |
| 8 |
on Amarok; add a note for those who might want Rio Karma support in |
| 9 |
Amarok; there's no need to get the whole history of the SVN ebuild |
| 10 |
rename, just call it 1.4.9999 from the start; consistently use <b> for |
| 11 |
USE flags and <c> for package names, as the xine-lib guide does. |
| 12 |
|
| 13 |
Revision Changes Path |
| 14 |
1.7 xml/htdocs/proj/en/desktop/sound/amarok.xml |
| 15 |
|
| 16 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/sound/amarok.xml?rev=1.7&view=markup |
| 17 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/sound/amarok.xml?rev=1.7&content-type=text/plain |
| 18 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/sound/amarok.xml?r1=1.6&r2=1.7 |
| 19 |
|
| 20 |
Index: amarok.xml |
| 21 |
=================================================================== |
| 22 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/sound/amarok.xml,v |
| 23 |
retrieving revision 1.6 |
| 24 |
retrieving revision 1.7 |
| 25 |
diff -u -r1.6 -r1.7 |
| 26 |
--- amarok.xml 30 Jun 2007 14:30:42 -0000 1.6 |
| 27 |
+++ amarok.xml 30 Dec 2007 15:08:36 -0000 1.7 |
| 28 |
@@ -1,6 +1,6 @@ |
| 29 |
<?xml version="1.0" encoding="UTF-8"?> |
| 30 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 31 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/sound/amarok.xml,v 1.6 2007/06/30 14:30:42 flameeyes Exp $ --> |
| 32 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/sound/amarok.xml,v 1.7 2007/12/30 15:08:36 flameeyes Exp $ --> |
| 33 |
|
| 34 |
<guide link="/proj/en/desktop/sound/amarok.xml" lang="en"> |
| 35 |
<title>Amarok package maintenance</title> |
| 36 |
@@ -18,8 +18,8 @@ |
| 37 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 38 |
<license/> |
| 39 |
|
| 40 |
-<version>1.5</version> |
| 41 |
-<date>2007-06-30</date> |
| 42 |
+<version>1.6</version> |
| 43 |
+<date>2007-12-30</date> |
| 44 |
|
| 45 |
<chapter> |
| 46 |
<title>Amarok</title> |
| 47 |
@@ -30,7 +30,7 @@ |
| 48 |
<body> |
| 49 |
|
| 50 |
<note> |
| 51 |
-This guide was last updated for Amarok 1.4.6-r1. |
| 52 |
+This guide was last updated for Amarok 1.4.8. |
| 53 |
</note> |
| 54 |
|
| 55 |
<p> |
| 56 |
@@ -115,10 +115,11 @@ |
| 57 |
</p> |
| 58 |
|
| 59 |
<p> |
| 60 |
-Due to a series of bugs in xine-lib, and some sanity checks applied by |
| 61 |
-Amarok, since verison 1.4.2 of the player, it is required to have |
| 62 |
-xine-lib 1.1.2 or later to play FLAC file (or a CVS snapshot just |
| 63 |
-before it), and xine-lib 1.1.3 to play Shorten (SHN) files. |
| 64 |
+Due to a series of bugs in xine-lib, and some sanity checks applied by Amarok, |
| 65 |
+since verison 1.4.2 of the player, it is required to have xine-lib 1.1.2 or |
| 66 |
+later to play FLAC file (or a CVS snapshot just before it), and xine-lib 1.1.3 |
| 67 |
+to play Shorten (SHN) files. Similar issues might come in the future, as Amarok |
| 68 |
+reflects xine's bugs on a probably wider range of users. |
| 69 |
</p> |
| 70 |
|
| 71 |
</body> |
| 72 |
@@ -157,7 +158,7 @@ |
| 73 |
<body> |
| 74 |
|
| 75 |
<p> |
| 76 |
-As a full-fledged media player, Amarok also provides support for transmitting |
| 77 |
+As a full-fledged media player, Amarok also provides support for transferring |
| 78 |
songs to and from media devices, like mp3 players and similars. Its architecture |
| 79 |
allows to build plugins for special devices on request, which requires adding |
| 80 |
more USE flags to the ebuild to handle new media device plugins from release to |
| 81 |
@@ -166,15 +167,21 @@ |
| 82 |
|
| 83 |
<p> |
| 84 |
Currently the supported media devices from the ebuild are the generic USB Mass |
| 85 |
-Storage (that requires no dependencies), the iPod devices (using libgpod), |
| 86 |
+Storage (requiring no dependencies), the iPod devices (using <c>media-libs/libgpod</c>), |
| 87 |
the IFP-based devices, early iRivers (using libifp), and the Nomad devices |
| 88 |
(using libnjb). MTP-based media devices are supported by Amarok using libmtp |
| 89 |
since version 1.4.2 onward, but the support is only present in ebuilds since |
| 90 |
-version 1.4.4 onward, because precedently noone checked its support. Rio Karma |
| 91 |
+version 1.4.4 onward, because precedently noone tested its support. Rio Karma |
| 92 |
support is present in Amarok since version 1.4.4, but it requires packages |
| 93 |
-currently not in portage to work (and one of them is a kernel module). |
| 94 |
+currently not in portage to work (and one of them is a Linux kernel module). |
| 95 |
</p> |
| 96 |
|
| 97 |
+<note> |
| 98 |
+If you want to request Rio Karma support, you should understand that any bug |
| 99 |
+that the support will bring on you'll have to handle yourself, it will be a de |
| 100 |
+facto proxy maintainership. |
| 101 |
+</note> |
| 102 |
+ |
| 103 |
</body> |
| 104 |
</section> |
| 105 |
|
| 106 |
@@ -183,7 +190,7 @@ |
| 107 |
<body> |
| 108 |
|
| 109 |
<p> |
| 110 |
-Since version 1.4, Amarok ebuild requires <b>dev-lang/ruby</b> forcefully; this |
| 111 |
+Since version 1.4, Amarok ebuild requires <c>dev-lang/ruby</c> forcefully; this |
| 112 |
is upon request by upstream, as the lyrics retrieval support, and the scoring |
| 113 |
and rating algorithms are now implemented as Ruby scripts. Then in version 1.4.1 |
| 114 |
also the last.fm proxy support, to play last.fm streams, was implemented this |
| 115 |
@@ -192,22 +199,15 @@ |
| 116 |
</p> |
| 117 |
|
| 118 |
<p> |
| 119 |
-Since version 1.4.4-r4 onward, Amarok depends on |
| 120 |
-<b>www-servers/mongrel</b>. The reason for this is that before it |
| 121 |
-installed its own copy of mongrel, which would have been fine until |
| 122 |
-mongrel was not in portage, but might be a security breach now that |
| 123 |
-mongrel is in portage, as the extensions might be using the wrong |
| 124 |
-libhttp1.so library. For this reason the internal copy of mongrel is |
| 125 |
-removed after installation (the build time for that is risible) and |
| 126 |
-the external copy of mongrel is used. Note that older versions block |
| 127 |
-mongrel so that they cannot be installed together with it for safety. |
| 128 |
-</p> |
| 129 |
- |
| 130 |
-<p> |
| 131 |
-Since version 1.4.5, the dependency over <b>mongrel</b> is dependent |
| 132 |
-on the <c>daap</c> USE flag that enables or disables the support for |
| 133 |
-music sharing using Apple's Digital Audio Access Protocol. Note that |
| 134 |
-the client support is still enabled even if the USE flag is turned off. |
| 135 |
+Since version 1.4.4-r4 onward, Amarok depends on <c>www-servers/mongrel</c>; |
| 136 |
+since version 1.4.5, this dependency is optional over <b>daap</b> USE flag. The |
| 137 |
+reason for this is that before that revision it installed its own copy of |
| 138 |
+mongrel, which would have been fine until mongrel was not in portage, but might |
| 139 |
+be a security breach now that mongrel is in portage, as the extensions might be |
| 140 |
+using the wrong libhttp1.so library. For this reason the internal copy of |
| 141 |
+mongrel is removed after installation (the build time for that is risible) and |
| 142 |
+the external copy of mongrel is used. Note that older versions block mongrel so |
| 143 |
+that they cannot be installed together with it for safety. |
| 144 |
</p> |
| 145 |
|
| 146 |
</body> |
| 147 |
@@ -220,7 +220,7 @@ |
| 148 |
<p> |
| 149 |
As of version 1.4.5-r2, a new USE flag was added to Amarok: |
| 150 |
python. This flag is used to add a dependency over |
| 151 |
-<b>dev-python/PyQt</b>, or remove the Web Control script. |
| 152 |
+<c>dev-python/PyQt</c>, or remove the Web Control script. |
| 153 |
</p> |
| 154 |
|
| 155 |
<p> |
| 156 |
@@ -287,13 +287,7 @@ |
| 157 |
of sync with the official ebuild, installing in the wrong prefix or |
| 158 |
behaving inconsistently. To overcome this issue (that was wasting a |
| 159 |
lot of the maintainer's time), at the end of December 2006, a Live SVN |
| 160 |
-ebuild was added with the name <b>amarok-9999</b>. |
| 161 |
-</p> |
| 162 |
- |
| 163 |
-<p> |
| 164 |
-As of June 2007 the ebuild has been renamed to <b>amarok-1.4.9999</b> |
| 165 |
-to make it explicit that it refers to the 1.4 (stable) branch of |
| 166 |
-Amarok, and to free the version number 9999 for the future 2.0 Live ebuild. |
| 167 |
+ebuild was added with the name <c>amarok-1.4.9999</c>. |
| 168 |
</p> |
| 169 |
|
| 170 |
<p> |
| 171 |
@@ -321,10 +315,10 @@ |
| 172 |
</p> |
| 173 |
|
| 174 |
<p> |
| 175 |
-The main examples are transKode (<b>media-sound/transkode</b>) that |
| 176 |
+The main examples are transKode (<c>media-sound/transkode</c>) that |
| 177 |
allows to transcode music from one format to another on-the-fly when |
| 178 |
loading music to a portable media player device, and moodbar |
| 179 |
-(<b>media-sound/moodbar</b>) that replaces the feature previously |
| 180 |
+(<c>media-sound/moodbar</c>) that replaces the feature previously |
| 181 |
provided by exscalibar (that was unmaintained upstream and full of |
| 182 |
bugs). |
| 183 |
</p> |
| 184 |
|
| 185 |
|
| 186 |
|
| 187 |
-- |
| 188 |
gentoo-commits@g.o mailing list |
Archives