alin 05/05/17 19:41:47 Modified: xml/htdocs/doc/en fluxbox-config.xml Log: #92631 - fluxbox-generate_menu additions for >=0.9.13
Revision Changes Path 1.8 +36 -23 xml/htdocs/doc/en/fluxbox-config.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/fluxbox-config.xml?rev=1.8&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/fluxbox-config.xml?rev=1.8&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/fluxbox-config.xml.diff?r1=1.7&r2=1.8&cvsroot=gentoo Index: fluxbox-config.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/fluxbox-config.xml,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- fluxbox-config.xml 10 May 2005 17:08:43 -0000 1.7 +++ fluxbox-config.xml 17 May 2005 19:41:46 -0000 1.8 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="UTF-8"?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/fluxbox-config.xml,v 1.7 2005/05/10 17:08:43 cam Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/fluxbox-config.xml,v 1.8 2005/05/17 19:41:46 alin Exp $ --> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> @@ -24,8 +24,8 @@ <!-- See http://creativecommons.org/licenses/by-sa/2.0 --> <license/> -<version>1.1.0</version> -<date>2005-05-09</date> +<version>1.1.1</version> +<date>2005-05-17</date> <chapter> <title>Introduction</title> @@ -508,41 +508,54 @@ <body> <p> -The author uses a text editor to create menus, believing that menumakers -introduce too much clutter, often skip important packages, and don't always -work well with the styles Gentoo installs. If this sounds appealing to you, +The author uses a text editor to create menus. If this sounds appealing to you, please skip this section and proceed to <uri link="#manual_menu">editing menus -by hand</uri>. However, many disagree, so feel free to use the instructions -below to use two of the more common menu generators. +by hand</uri>. </p> <p> -Both of these programs provide a good organizational system, and it is possible -to edit <path>~/.fluxbox/menu</path> by hand after using them (see next -section), to either add packages or delete those which aren't used. Note that -if something is deleted from this menu, it does not delete the package from the -system, just from the individual user's menu. The program can still be run by -command-line. +It is possible to edit <path>~/.fluxbox/menu</path> by hand after using an +automatic generator (see next section), to either add packages or delete those +which aren't used. Note that if something is deleted from this menu, it does +not delete the package from the system, just from the individual user's menu. +The program can still be run by command-line. </p> +<!-- +This section will be changed slightly when fluxbox-0.9.13 goes stable in +portage on approx 2005-06-14 unless bugs crop up (as stated by ciaranm) +--> + <p> There is a program already on your system called <c>fluxbox-generate_menu</c>, -whose behaviour is similar to that of <c>mmaker</c>. This program does a better -job handling styles, but does not detect as many programs. To use it, simply -run the command. To install and use <c>mmaker</c>, see below. +which can be used to generate menus. If you have Fluxbox >=0.9.13, you have a +version of this program patched especially for Gentoo, enabling the script to +find many more packages than before. This script is almost infinitly better +than those before it, and found programs on my system that I didn't know +existed. To run it (as a non-root user): </p> -<pre caption="Installing menumaker"> -# <i>emerge menumaker</i> +<pre caption="Generating menus for >=fluxbox-0.9.13"> +$ <i>fluxbox-generate_menu -is -ds</i> </pre> <p> -Then, simply run <c>mmaker Fluxbox</c>. However, it is important to note that -while more programs are detected than by using <c>fluxbox-generate_menu</c>, -many major programs are still skipped. For example, neither gaim nor xchat are -found. +If you have a version of Fluxbox less than 0.9.13 (due to package masks or +keyword masks), simply type <c>fluxbox-generate_menu</c>. This program suffers +from the problems of ineffecient organization and an inability to find major +packages such as gaim. When 0.9.13 becomes stable, it is recommended that you +upgrade and use <c>fluxbox-generate_menu -is -ds</c> instead of other programs +such as <c>mmaker</c>, which do not understand Gentoo's directory structure. </p> +<note> +It is possible to use this method to auto-generate menus and still have some +manual control over your menu. Creating and editing +<path>~/.fluxbox/usermenu</path> by hand (see the next section for syntax) will +give a user a personalized menu which will not be erased the next time the +script is run. +</note> + </body> </section> <section id="manual_menu"> -- [email protected] mailing list
