FAQ patch for approval



Jeff Waugh (jdub perkypants org) wrote:
> <quote who="sams marketing-designs com">
> 
> > Can someone please please update the FAQ to include this issue, that way
> > we only get 4 emails a week about it?  I am more than willing to draw up
> > an html patch if need be.
> 
> Yes please. Patches first, ask questions later. :-)
Fair enough, attached.  Also closes Bug 117500 when applied.  Anything
else?  Ask and ye shall receive.
> 
> - Jeff

-- 
Samuel Stringham                   /"\    ASCII Ribbon Campaign
Computer Consultant                \ /    Respect for open standards
sams marketing-designs com          X     No HTML/RTF in email
                                   / \    No M$ Word docs in email
--- garnome_old.html	2003-07-15 22:50:24.000000000 -0500
+++ garnome.html	2003-07-15 22:49:50.000000000 -0500
@@ -10,7 +10,7 @@
 
 <body>
 
-<h1><center><img src="garnome_old.html.content/garnome.jpg" width="500" height="150" hspace="5" vspace="5" alt="¡GARNOME!"></center></h1>
+<h1><center><img src="garnome.html.content/garnome.jpg" width="500" height="150" hspace="5" vspace="5" alt="¡GARNOME!"></center></h1>
 
 	<p>GARNOME - the bad-ass, bleeding edge GNOME distribution for testers and
 	tweakers everywhere - is finally released unto the teeming masses. If
@@ -53,6 +53,7 @@
     <blockquote>libpng3-dev<br>
 	libjpeg-dev<br>
 	libtiff-dev<br>
+	libncurses5-dev<br>
     xlibs-dev<br>
 	xutils (for xmkmf, required by Xrender)<br>
     libpopt-dev<br>
@@ -68,6 +69,20 @@
     texinfo (librep)<br>
 	</blockquote>
 
+<a name="configure"><h2>How do I configure GARNOME?</h2></a>
+                                                                                
+    <p>All the local settings are kept in gar.conf.mk. Here are the
+    most useful ones:</p>
+                                                                                
+    <p><b>GARCHIVEDIR</b>: If you've downloaded the tarball collection
+already, point this to the directory your tarballs are in. Example:</p>
+                                                                                
+        <blockquote><tt>GARCHIVEDIR =
+        /home/jdub/src/cvs/gnome/garnome/DOWNLOAD</tt></blockquote>
+                                                                                
+    <p><b>main_prefix</b>: Currently the default install location is $HOME/garnome.
+    If you'd prefer to install GARNOME elsewhere, change this entry.</p>
+
 
 <h2>How do I use GARNOME?</h2>
 
@@ -86,21 +101,6 @@
 	meta/gnome-desktop garball!</p>
 
 
-<a name="configure"><h2>How do I configure GARNOME?</h2></a>
-
-	<p>All the local settings are kept in gar.conf.mk. Here are the
-	most useful ones:</p>
-
-	<p><b>GARCHIVEDIR</b>: If you've downloaded the tarball collection already,
-	point this to the directory your tarballs are in. Example:</p>
-	
-		<blockquote><tt>GARCHIVEDIR =
-		/home/jdub/src/cvs/gnome/garnome/DOWNLOAD</tt></blockquote>
-	
-	<p><b>main_prefix</b>: Currently the default install location is $HOME/garnome.
-	If you'd prefer to install GARNOME elsewhere, change this entry.</p>
-
-
 <a name="start"><h2>How do I start GARNOME once it is installed?</h2></a>
 
 	<p>The easiest way is to create a garnome-session script, and use the
@@ -181,7 +181,9 @@
 
 		<p>Probably not - are you using a non-English system and GARNOME 0.5.x?
 		If so, please upgrade to a more recent version, as there is a fix for
-		this suggested by Rafael Rigues from Conectiva. Thanks Rafael!</p>
+		this suggested by Rafael Rigues from Conectiva. Thanks Rafael!
+		Are you using GNU tools?  Sometimes Sun's md5sum doesn't agree
+		with garnome</p>
 
 		
 		<li><b>My build fails saying it can't find libglade-convert, but I've
@@ -275,12 +277,30 @@
 
 		<p>Make sure you save your session when logging out.</p>
 
+		<li><b>My build fails with: <tt>/usr/bin/install: cannot stat 
+		`./html/index.sgml': No such file or directory</tt></b></li>
 		
-		<li><b>Who do I talk to about GARNOME?</b></li>
 
-		<p>Join our <a href="http://mail.gnome.org/mailman/listinfo/garnome-list";>mailing
-		list</a>, or visit #garnome on irc.gnome.org.</p>
+		<p>3 different solutions, in order from "most rightest" to "most
+		fastest"
+		<ol>
+		<li> Find out why <tt>gtkdoc-mkdb</tt> is failing (usually a
+		b0rked/non-existant docbook-dsssl install)
+		<li> <tt>touch $dirname/html/index.sgml</tt> and continue with the 
+		make</li>
+		<li> change <tt>--enable-gtkdoc</tt> to <tt>--disable-gtkdoc</tt> 
+		in the gar.conf.mk file</li>		
+		</ol>
+		<br/>
+		</p>
+
+		<li><b>I have questions about GARNOME?</b></li>
+
+		<p>Join our 
+		<a href="http://mail.gnome.org/mailman/listinfo/garnome-list";>
+		mailing list</a> (note the search functionality is <b>not</b>
+		working), or visit #garnome on irc.gnome.org.</p>
 	
 	</ol>
 
-</body></html>
\ No newline at end of file
+</body></html>

Attachment: pgpR0y0O4QaK2.pgp
Description: PGP signature



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]