==========================
README: For K-Meleon's "KM-Walnut" for v0.8 and above.
==========================


TABLE OF CONTENTS:

How to change skins.
How to change enclosed background.
#1: My K-Meleon ("K-Meleon Help") Button.
#2: Email Button.
#3: Toolbar "Helper" icons.
#3a: Search from URL address field using Google.
#3b: Google News.
#3c: Open Layer/Layer Closed.
#3d: Disabling Java Button. (Thanks to jsnj!)
#3e: Comclear Button.

Please read for file information, pertinent details, and thank yous.
________________________________________


How to change skins:

* Extract the files into "C:\Program Files\K-Meleon\skins\KM-Walnut" (You'll have to more than likely make the folder when unzipping).
* Open K-Meleon, go to Edit>Preferences>Display>Skin and select a skin from the list.
* Select "Show Toolbar Background". Click OK.
* Exit K-Meleon and loader if used. You will restart K-Meleon with the new skin.


You'll notice a lot of buttons in with this theme. I'm enclosing the macros here along with simple directions to make them operational. :o)
________________________________________

#1: MY K-MELEON ("K-Meleon Help") BUTTON:

(Please note: When this button was first added to my first theme, "Netscape Modern", it WAS called "My K-Meleon Button". I've liked it so much and found it so useful for immediately getting to the K-Meleon Homepage that I've left it in subsequent themes under different names. In this theme I've renamed it "K-Meleon Help" as it's a fabulous way to find help quickly! But rather than ME try, with my defective brain, to remember which to change where, just think in this theme: "K-Meleon Help" because the MACRO for it still remains as "MyKMeleon", okie?)

Looking along the iconbar you'll notice several additions. A few of these will require macros. Netscape has the "My Netscape" button which I like and wanted in my browser to quickly reach the K-Meleon Homepage. In fact, when I load a theme I usually add this button. ;) IF YOU DON'T WANT THE BUTTON: Open "Edit/Preferences/Configs/Toolbars" and scroll down until you find "My K-Kmeleon". Starting in front of that until the "}" place these "#" in a descending column on the left. It'll look like this to better show you:

#-
#   K-Meleon Help{
#      macros(MyKMeleon)
#      K-Meleon Help
#      hottool.bmp[24]
#      hottool.bmp[24]
#      hottool.bmp[24]
#   }

Press "Ok" and a box will come up asking you if you'd like to save your changes. Press "Yes" and restart K-Meleon and the button will be gone. ;o) IF, however, you'd like that button to remain and to work, go to "Edit/Preferences/Configs/Macros" and scroll all the way to the bottom. Click in the box and press "enter" on the keyboard to make an extra space and copy/paste the following:

MyKMeleon {
   menu=My K-Meleom
   open("http://kmeleon.sourceforge.net/");
}

Again, press "Ok", a box will come up asking you to save, press "Yes", restart K-Meleon, and when you press that button it will take you to the homepage! :o)

Congratulations! You've just done your first macro if you've never done one before! Now, see how EASY it is to configure K-Meleon? And all this time you thought it was HARD! tsk, tsk!
________________________________________

#2: EMAIL BUTTON:

Frequent question on the forum: "How do I hook up my email programme to work with K-Meleon?" Tada! I'm going to show you! Now this one LOOKS hard but it really isn't. And yes---this is the next button beside the "Search" button. If you don't want it, go to "Edit/Preferences/Configs/Toolbars" and search for "Mail" in the lineup and carry out the instructions found in the "My K-Meleon Button" example. (I'm bound and determined that you'll read this file >wink<.) IF, however, you'd like to make this button operational there are several things you must do: First, open your file manager (like Explorer, 2xExplorer, etc.) and look for the proper pathway and name of your email exe file. Write it down! Then go to "Edit/Preferences/Configs/Macros" and copy/paste the following---remembering to leave a space between this and your last macro:

exec_Mail {
menu=&Mail Client
exec("\"C:\\Program Files\\Folder\\name of programme.exe\"");
}

So let's say it's GoofyMail and made by Mickey company, okie? The pathway would look thus: ("\"C:\\Program Files\\Mickey\\GoofyMail.exe\""); provided it was actually in a subfolder by the name of "Mickey", etc. Pay VERY STRICT ATTENTION to this detail or this macro will not work! If you do though you'll see it's actually easier than you thought. :o)

Now, let's be able to call our email programme up with a keyboard shortcut as well, shall we? Let's go back into "Edit/Preferences/Configs/Accelerators" and at the bottom---remembering to leave a space once again---copy/paste in the following:

%ifplugin macros
CTRL M = macros(exec_Mail)
%endif

Remember to save, but we're still not done so don't restart K-Meleon just yet. What this shortcut allows you to do is press Ctrl+M and it'll open your email programme. Neat!

Now some people like to also call up their email client from the drop-down menubar. I have mine in "File" between "Save As" and "Print". This is what you copy/paste there:

 - 
%ifplugin macros
   macros(exec_Mail);
 %endif

Remember that little "-" if you want a seperate line to set it off between the "Save As" and the "Print". In other words, make sure there's one before and after this shortcut. And NOW save all of your work, exit K-Meleon and the Loader (if using it), restart, and try out your shortcuts and button to see if they work. If not, re-check everything again CAREFULLY. Usually it's just something as simple as the pathway to your email programme being off by a letter. If it DID work, congratulations! You've made a mini-browser suite and your life a whole lot easier! :o)
________________________________________

#3: TOOLBAR "HELPER" ICONS:

#3a: SEARCH FROM URL ADDRESS FIELD USING GOOGLE:

In my own personal themes I remove the "Search" icon from the iconbar as I like doing my searches from the URL bar, like in Mozilla/Firefox. So I've added the search there. Type in a word in the URL bar, press the "Magnifying Glass" icon and this will search Google. Again, if you do NOT wish to have this icon the procedure for removal is covered in "MY K-MELEON BUTTON" above. If you choose to use it go to "Macros" (by now you should know where it's located? "Edit/Preferences/Configs/Macros") and copy/paste the following macro---remembering to leave a space from your last macro:

search_button {
    $google = "http://www.google.com/search?q=";
    $oldclip = getclipboard();
    id(ID_SELECT_URL);
    id(ID_EDIT_COPY);
    $query = getclipboard();
    setclipboard($oldclip);
    open($google . $query);
}

Save this, restart K-Meleon, and the search button will work. Give it a try! :o)

(The standard iconbar "Search" is still located on the menubar under "Go" and will bring up a search box FYI, plus I've left the standard search icon in the iconbar in this theme.)
________________________________________

#3b: GOOGLE NEWS:

Yes, that's what the "Magnifying Glass on the Paper" is in this theme. Now while I myself don't keep up much on the news, occasionally when I do my news page of choice is Google News and I thought this would make a great addition. :o) If you've been reading through this Readme/Help File then you'll know how to disable it as discussed in #1: "MY K-MELEON BUTTON". If you wish to use it, however, go into macros and paste the following:

open_News {
   menu=Google News
   open("http://news.google.com/");
}

Of course, by now I suspect that you're getting pretty good at these macros so you'd know how to change that URL to open any other News Service, or website that you'd like. Maybe ebay? If you DO change it, make sure that you go into "Toolbars" and change the "Display Name" line to read appropriately. The "Display Name" would be "Google News" before "extramenu.bmp[7]".
________________________________________

#3c: LAYER OPEN/LAYER CLOSED:

This HAS to be one of THE MOST asked questions on the forum when it comes to adding buttons I think! :o) "How can I add a simple button to open and close my 'tabs'?" We'll handle them both together since I doubt anyone will want to add one without the other. Disabling these is done the same way as any toolbar button as the example discussed in #1: "MY K-MELEON BUTTON". If you wish to keep and use these---and trust me, they are HANDY!---copy/paste the following into macros, remembering to leave a space before your last macro added:

close_layer {
      %ifplugin layers
      plugin(layers,Close)
      %endif
}

open_layer {
      %ifplugin layers
      plugin(layers,Open)
      %endif
}

Save your changes/additions, restart K-Meleon, and your new "Tab" buttons should work. Hey! Okie, so they're layers. Sue me! I come from a long line of tabbed browsers. ;o) I even changed them in User.js by adding this setting to read "Tabs": user_pref("kmeleon.plugins.layers.title", "Tabs:"); MAKE SURE you copy the entire line from "user" to ";" and go to: "Edit/Preferences/Settings/User.js" and place it there. ;o) And now once you restart K-Meleon you'll have a "tabbed" browser and no one will know the difference but YOU and other K-Meleon users. --ahem!--

________________________________________

#3d: DISABLING JAVA BUTTON:

jsnj of the K-Meleon Homepage forums provided us with a button that enables us to disable java upon request. Sometimes I've noted that this comes in handy, especially if you're speed-browsing just for quick information---when you need to find it fast and not wait for java to open up. This button is the little coffee cup (Neat, yes?). One note: Pressed in and java works. Unpressed and java does NOT work. This confused me a little at first so I thought I'd pass this along. Just think this: "Steaming coffee: Java works. Empty cup: No java."

This button is a little harder to hook up as it HAS to go in a special place in macros in order for it to work, for K-Meleon to read it. You are going to look for a macro that starts with "PGToggle{" after the "}" you are to skip a space and paste in the following macro:

JSToggle{
$tmp = (getpref(BOOL, $jscript) ? false : true);setpref(BOOL, $jscript, $tmp);
statusbar("JavaScript " . ($tmp ? "ENABLED" : "DISABLED"));&buttonSync;
}

Make SURE that you leave a space between this and the next macro which will start with "ImgToggle{".

Remember! Save your changes! ;)

________________________________________

#3e: COMCLEAR BUTTON:

You'll notice in this theme that there is a little Gnome "trashcan" on the toolbar. A lot of people like to clear their cookies and cache after closing their browser. In the forum there are several ways mentioned to do this. Some are .bat files but I've never had success getting these to work 100% of the time. Alain, one of our members, does put out a "CookieMonster" programme. But the "ComClear" programme takes care of BOTH. (It's also supposed to clear the history but has a bug and doesn't for some reason.) Though developed for Netscape it works for any Gecko-based browser. This nifty little programme may be obtained from this URL: http://www.neuro-tech.net/

Install ComClear to "C:\Program Files\Comclear" for the following macro to work properly.

In the Macro section of "Config" add this at the bottom of your list making sure that you leave a space between your last macro and this one:

exec_ClearCache {
exec("\"C:\\Program Files\\Comclear\\Comclear.exe\"");
}

If you've added ComClear to the directory in Program Files which I've directed then before closing your browser click on the trashcan. ComClear will come up. Before you can use it the first time you'll need it to scan for your "Profile Directory". Check the first four boxes to the right, and then press the button marked "Rescan". This will find ANY profile directories on your computer for a Gecko-based programme (So this is great to use with Netscape, Mozilla, K-Meleon, Beonex and Firefox!). Once it has finished scanning they will show up in the window. Select the COMPLETE pathway, as sometimes it doesn't do so, and---making SURE that your browser is CLOSED, press the button that says "Clear". A GUI will come up afterwards telling you "Ok", or something like that, meaning that the directories have been cleared.

From now on all you will need do is before closing the browser is click on the trashcan, THEN close K-Meleon, press the "Clear" button, and your cookies, drop-down field, and cache will be completely cleared! :) Very simple, yes? I knew you'd agree! In fact, I've even made a shortcut to ComClear on my "Quick Launch" menu so that I can use this for my Netscape, Mozilla, Beonex and Firefox browsers---I like it that much!

This programme is no longer being supported nor updated. If you are unable to download it then let me know and I'll make arrangements so you can download it from my server.

________________________________________

PLEASE READ FOR FILE INFOMATION, PERTINENT DETAILS, AND THANK YOUS:

Base iconbar icons and some menu icons from the skin "Fedora for MyIE" by Picto with numerous alterations by me (Eyes-Only/L'Peau-Rouge) and found at: http://www.skinnable.com/myie2/skins.asp
Gnome icons obtained from Mozilla Nautipolis skin by Alfred Kayser and available from his website at: http://www.geocities.com/alfredkayser/mozilla/themes.htm
Generic throbber by Al for K-Meleon and likewise available in the throbber section for free and may be found at: http://kmeleon.sourceforge.net/
Any other icons not attributed to a source may have been made by me (Eyes-Only/L'Peau-Rouge). Heck if I know---I have a bad memory. But I did make several for this theme.

K-Meleon Homepage: http://kmeleon.sourceforge.net/
Eyes-Only Homepage (where I'm known as "jimmymac"): http://eyesonly.no-ip.info/jimmymac/ Here you can learn more about me, my interests and hobbies, artwork, physical illnesses, and a whole lot more. :o)
My email: LeSauvage@eyesonly.no-ip.info (Down on Sundays between 21:00hrs to 21:30hrs EST for system maintenance). I will TRY to answer all questions but it's best to ask on the K-Meleon Homepage being VERY specific as to what the problem is and the macro, etc, with which you are working. I have a serious memory problem and this is NOT a joke.

FOR THANKS:

I would like to thank the Great Spirit for giving me each day of Life and for the gift of my grandson, Isaac James, who has inspired me to continue living despite great pain and sickness.

I would like to thank Lynchknot, Aaron, Mr. Kayser and now CatThief, who have been a great inspiration to me in my theming---even if it wasn't browsers for which I themed (I originally started out as a themer for Aston Shell). They are not only the Greatest Masters in their fields, but true artists in every sense of the word. Thank you gentlemen!

I would like to thank the hard-working Devs and beta-testers who continue to put out K-Meleon, which in my humble opinion, is the very best browser in the field today. It is through your diligence, continued work and patience that you have kept this project not only alive---BUT THRIVING! And all of you, you know who you are, from the greatest to the smallest, as you ALL play a priceless part.

This theme is Copylefted Big Bang By the Entire Planet Earth. Unless, of course, they are successful in finding life on Mars, then we'll have to include them in too. ;o