Created man pages and a HOMEPAGE/SRC_URI fix.

5 files changed, 175 insertions, 8 deletions

diff --git a/x11-misc/idesk/ChangeLog b/x11-misc/idesk/ChangeLog
index 87153209eaa9..bd6396b5dba2 100644
--- a/x11-misc/idesk/ChangeLog
+++ b/x11-misc/idesk/ChangeLog
@@ -1,7 +1,16 @@
 # ChangeLog for x11-misc/idesk
 # Copyright 2002-2003 Gentoo Technologies, Inc.; Distributed under the GPL v2
-# $Header: /var/cvsroot/gentoo-x86/x11-misc/idesk/ChangeLog,v 1.8 2003/06/09 13:24:17 bcowan Exp $
+# $Header: /var/cvsroot/gentoo-x86/x11-misc/idesk/ChangeLog,v 1.9 2003/06/09 22:39:55 absinthe Exp $
 
+  09 Jun 2003; Dylan Carlson <absinthe@gentoo.org> idesk-0.3.5-r2.ebuild,
+  files/idesk.1, files/ideskrc.5:
+  DAMN IT, BRAD.  I wish I would have seen that a few hours ago.
+
+  *sigh* ... well, after wasting time creating manpages for 0.3.5 and a website,
+  I'm posting them anyway. The new website for 0.5.5 is focused on the new 
+  version -- so my webpage is still relevant, particularly for hosting the
+  click patch and man pages.
+  
 *idesk-0.5.5 (09 Jun 2003)
 
   09 Jun 2003; Brad Cowan <bcowan@gentoo.org> idesk-0.5.5.ebuild:
diff --git a/x11-misc/idesk/Manifest b/x11-misc/idesk/Manifest
index 324ae8cd3b41..92af74824f88 100644
--- a/x11-misc/idesk/Manifest
+++ b/x11-misc/idesk/Manifest
@@ -2,8 +2,8 @@ MD5 aa24bca5b5d637121b5fc16b9a55a84d idesk-0.3.5-r1.ebuild 1749
 MD5 de294551b0aa9f076a6421c176263353 idesk-0.5.5.ebuild 1758
 MD5 1e2f5916f5d6b5ff9c816fd1decc2f10 idesk-0.3.3.ebuild 1739
 MD5 4921b8b75ad4682f8c17210c9e57de1f idesk-0.3.5.ebuild 1739
-MD5 de159bc9c928a82b224cff25432bf349 idesk-0.3.5-r2.ebuild 1807
-MD5 00ca69f84c4906b81e680ad420b3201b ChangeLog 1604
+MD5 ce1a8319aec6781051cc38013e12467f idesk-0.3.5-r2.ebuild 1776
+MD5 1356cfdd13cd060caf495203c8d72588 ChangeLog 2044
 MD5 c05165d09278f218e5eafbbd3e188f86 idesk-0.3.4.ebuild 1739
 MD5 8b29339fdf933c6dfac6f605f3b306e4 files/idesk-0.3.5-clickbox-and-singleclick.patch 6762
 MD5 2aae27b79a7df7030bfec00195d5a04c files/digest-idesk-0.3.3 61
@@ -12,3 +12,5 @@ MD5 cf9fcef8d97bb24948cfe2ee88de481e files/digest-idesk-0.3.5 61
 MD5 3a9d908ed69b11ea011dc2a7cc439ac5 files/digest-idesk-0.5.5 62
 MD5 cf9fcef8d97bb24948cfe2ee88de481e files/digest-idesk-0.3.5-r1 61
 MD5 cf9fcef8d97bb24948cfe2ee88de481e files/digest-idesk-0.3.5-r2 61
+MD5 936075c618affeca8533c3ecab323871 files/idesk.1 2485
+MD5 7391b893cc28213bef73f7f929155698 files/ideskrc.5 2329
diff --git a/x11-misc/idesk/files/idesk.1 b/x11-misc/idesk/files/idesk.1
new file mode 100644
index 000000000000..b7fe675da47e
--- /dev/null
+++ b/x11-misc/idesk/files/idesk.1
@@ -0,0 +1,76 @@
+.TH "idesk" "1" "" "" ""
+.SH "NAME"
+idesk \- Adds desktop icons to the root X window
+.SH "SYNOPSIS"
+Idesk allows desktop icons to be added to the root window of an X session, placed freely wherever desired.  The icons "glow" on mouse\-over, and the icons themselves can be any size.  Other attributes, such as font, font size, transparency, and shadows are configurable.
+.SH "INSTALLING"
+Idesk is known to run on FreeBSD, Linux, NetBSD, OpenBSD.  If a package is not available for your platform, you can compile it from source.
+.PP
+\fBSteps:\fR
+.IP
+1. Unpack the source tar.gz to a desired location.\bR
+.br
+2. From that location, run \fImake\fR.
+.br
+3. As root from that location, run \fImake install\fR.
+
+.SH "CONFIGURING"
+\fBSTEPS\fR
+.PP
+\fB1.\fR Following the syntax described in \fIideskrc(5)\fR, create a file
+in your home directory named .ideskrc.
+.PP
+\fB2.\fR Create a directory called .idesktop/ in your home directory. 
+.PP
+\fB3.\fR Inside the new directory, create an icon file with the extension 'lnk'
+(e.g., home.lnk).  Inside the file put something like this:
+.IP
+table Icon
+  Caption: Mozilla
+  Command: /usr/bin/mozilla 
+  Icon: /usr/share/icons/mozilla.png
+.br
+end
+.PP
+\fB4.\fR Start idesk as described in \fIRUNNING\fR below, or kill and
+restart idesk if it's already running.
+.PP
+\fB5.\fR Move your new icon to where you would like it to be, and verify
+it works correctly.
+.PP
+\fB6.\fR Repeat steps 3-5 for any additional icons you would like to have.
+.PP
+\fB7.\fR After you have your icons finished and where you want them, change
+\fILocked\fR from 'false' to 'true' in .ideskrc.
+.PP
+\fB8.\fR (optional) Add 'idesk' to your .xinitrc or other startup scripts to run it automatically.
+
+.SH "RUNNING"
+Idesk runs as a background process.  One suggested way to start idesk is:
+.IP
+nohup idesk > /dev/null &
+.PP
+After Idesk is running, click on an icon to start whatever command you 
+assigned it.  Currently 'kill -HUP' will terminate the program.  It is 
+required to restart idesk when you add new icons (.lnk files), unless
+you are running some other utility that runs on top of idesk, such as
+Fluxspace.
+
+You can reload existing .lnk files in ~/.idesktop/ by middle-clicking 
+on any icon.
+
+.SH "SEE ALSO"
+\fIideskrc(5)\fR
+
+.SH "PROGRAM AUTHORS"
+.IP
+Chris Roberts (nikon) <nikon@sc.rr.com>
+.br
+Bryn (curious) <curious@ihug.com.au>
+.br
+Christopher Morris <cmorri9@lsu.edu>
+.br
+Tim Finley <timmfin@timmfin.net>
+.SH "MANPAGE AUTHOR"
+.IP
+Dylan Carlson <absinthe@gentoo.org>
diff --git a/x11-misc/idesk/files/ideskrc.5 b/x11-misc/idesk/files/ideskrc.5
new file mode 100644
index 000000000000..ff693a50cf04
--- /dev/null
+++ b/x11-misc/idesk/files/ideskrc.5
@@ -0,0 +1,80 @@
+.TH "ideskrc" "5" "" "" ""
+.SH "NAME"
+ideskrc \- Configuration file for idesk(5)
+.SH "USAGE"
+The .ideskrc file needs to be placed in the root of your home directory.
+.SH "FORMAT"
+The structure of the file is as follows:
+.IP
+table Config
+  <setting>: <value>
+.br
+end
+.PP
+Anything else in the file will be ignored.
+.SH "SETTINGS"
+\fIBold\fR: boolean (true/false)  If 'true', this will make your font bold.
+
+\fIDoubleClick\fR: boolean (true/false)  If 'false', you only need to click
+once to launch the icon.  If 'true' (default) icons require double-clicking.
+Note: This feature may not be available in your platform's version of idesk.
+
+\fIFontColor\fR: (hex value, #RRGGBB)  Sets the color of the desired font.
+
+\fIFontName\fR: the name of the desired font.
+
+\fIFontSize\fR: the point size of the desired font.
+
+\fIHighContrast\fR: boolean (true/false)  An alternative to Shadow.  If 'true',
+draws a border around the text in the opposite color.  If 'false', it is
+disabled.
+
+\fILocked\fR: boolean (true/false).  Prevents the icons from being moved.
+
+\fIPaddingX\fR, \fIPaddingY\fR: (pixels)  The amount of desired padding around the icon.
+
+\fIShadow\fR:  boolean (true/false)  Turning this on will draw a drop 
+shadow of color ShadowColor behind the text.  The shadow will be ShadowX 
+pixels right and ShadowY pixels down (negative values will work).  Both 
+ShadowX and ShadowY default to 1.
+
+\fIShadowColor\fR:  (hex value, #RRGGBB)  Sets the color of the drop shadow.
+
+\fIShadowX\fR, \fIShadowY\fR: (pixels) Sets the size and direction of the drop shadow.
+
+\fITransparency\fR: (0-255)  Determines the alpha transparency of the icon 
+before a mouse-over.  If '0', the icon will be invisible without moving your 
+mouse over it.    If '255', mouse-over glow is disabled.
+.SH "EXAMPLE"
+table Config
+  FontName: verdana
+  FontSize: 11
+  FontColor: #ffffff
+  PaddingX: 25
+  PaddingY: 25
+  DoubleClick: false
+  Transparency: 100
+  HighContrast: false
+  Locked: false
+  Shadow: true
+  ShadowColor: #000000
+  ShadowX: 222
+  ShadowY: 22
+  Bold: false
+.br
+end
+.SH "SEE ALSO"
+\fIidesk(1)\fR
+
+.SH "PROGRAM AUTHORS"
+.IP
+Chris Roberts (nikon) <nikon@sc.rr.com>
+.br
+Bryn (curious) <curious@ihug.com.au>
+.br
+Christopher Morris <cmorri9@lsu.edu>
+.br
+Tim Finley <timmfin@timmfin.net>
+.SH "MANPAGE AUTHOR"
+.IP
+Dylan Carlson <absinthe@gentoo.org>
diff --git a/x11-misc/idesk/idesk-0.3.5-r2.ebuild b/x11-misc/idesk/idesk-0.3.5-r2.ebuild
index 1b35b3971a6d..6ea95e0f613e 100644
--- a/x11-misc/idesk/idesk-0.3.5-r2.ebuild
+++ b/x11-misc/idesk/idesk-0.3.5-r2.ebuild
@@ -1,14 +1,13 @@
 # Copyright 1999-2003 Gentoo Technologies, Inc.
 # Distributed under the terms of the GNU General Public License v2              
-# $Header: /var/cvsroot/gentoo-x86/x11-misc/idesk/idesk-0.3.5-r2.ebuild,v 1.1 2003/06/09 07:07:33 absinthe Exp $                                                                    
+# $Header: /var/cvsroot/gentoo-x86/x11-misc/idesk/idesk-0.3.5-r2.ebuild,v 1.2 2003/06/09 22:39:55 absinthe Exp $                                                                    
 DESCRIPTION="Utility to place icons on the root window"                         
                                                                                 
-HOMEPAGE="http://linuxhelp.hn.org/idesk.php"                           
-SRC_URI="http://linuxhelp.hn.org/${P}.tar.gz"                  
-                                                                                
+HOMEPAGE="http://cvs.gentoo.org/~absinthe/idesk/index.html"
+SRC_URI="http://cvs.gentoo.org/~absinthe/idesk/${P}.tar.gz"                  
 LICENSE="BSD"                                                                   
 SLOT="0"                                                                        
-KEYWORDS="~x86 ~ppc"
+KEYWORDS="x86 ~ppc"
                                                                                 
 DEPEND=">media-libs/imlib-1.9.14
 	virtual/x11
@@ -36,6 +35,7 @@ src_install() {
 	exeinto /usr/bin
 	doexe idesk	                                  
 	dodoc README
+	doman ${FILESDIR}/idesk.1 ${FILESDIR}/ideskrc.5
 }                                                                               
 
 pkg_postinst() {