1. cmext110.zip Driver
2. Readme.txt File Contents

Readme.txt Driver File Contents (cmext110.zip)

CMenuExtender 1.1.0.0
Part of Revengers Shell Extensions.
-----------------------------------
This is the readme-file for CMenuExtender.
Check out License.txt for (c) and such.

1. Description
2. Installation
3. Uninstallation
4. Editing the menu
5. Special commands
6. Q&A 
7. Contact
8. Examples


1. Description
--------------
CMenuExtender is a dll-file (and an installation-file and an editor and
a couple of textfiles) that adds items and submenus to the standard
Explorer rightclick-menu, or context-menu which is the correct name. 
The menus can contain shortcuts to folders, documents, programs, web-
pages, mailaddresses, scripts and so on. CMenuExtender also uses nested
menus (menus containing submenus), so that the user can organize 
his/hers/its shortcuts in a neat and ordered fashion. The user can make
new shortcuts and submenus using good old Regedit.exe or any other
registry-editor. CMenuExtender also comes with a not-very-userfriendly,
non-fancy and slightly-reliable GUI-editor.

2. Installation
---------------
To install the extension:
 Unzip the files to any folder on your computer, right-click the file
 "CMExt.inf" and select "Install". Some files will be copied and then
 CMenuExtender is installed. If you're asked to reboot your computer,
 answer "No". (Answer "Yes" if you have installed CMenuExtender 
 before.) You can also use the program regsvr32.exe or other 
 COM-server-registration-programs.
To install the GUI-editor:
 Copy the file cmexted.exe to a folder on your computer.
The unzipped files can be deleted.

3. Uninstallation
-----------------
To uninstall the extension:
 Use "Add/Remove Programs" in the Control Panel. All files will be
 removed. Some registry-entries might be left behind, but they won't
 cause any problems.
To uninstall the GUI-editor:
 Delete the file cmexted.exe

4. Editing the menu
-------------------
This information is directed to those who prefer to edit the extension
with regedit.exe. Most people probably wants to use the GUI-editor.
See CMExtEd.txt for a brief manual on CMExtEd.

All information is stored in the system registry. There's always a 
risk involved when editing the registry, but if you know what you're
doing there shouldn't be any problems. The information is located
in HKEY_CURRENT_USER/Software/Revenger inc./CMenuExtender/.
The subkey "Contents" contains the shortcuts and menus that appears in
the contextmenu. There are some special names that shouldn't be used,
see below. Apart from that you can add new menuitems for as much as you
like. The items appears in the menu in creation-order, i.e. the last
key you edit in the registry appear at the bottom of the menu. 
If you want to add a submenu, just create a new subkey under 
"Contents". The name of the new subkey will be the name of the submenu.
Submenus are added to the top of the "owner-menu".

The syntax for registry keys: (Left of the "-" is the keyname, right of
it is the keys value.)
 
  <Any random string> - <Name>¶[%|%%]<Path to a file>[?<flags>]

<Any random string> is the name of the key. It can be any valid string.
cmexted defaults to using "item$", where "$" is a number.  
<Name> is, of course, what the item will be called when opening the
menu, or one of the special commands. See below.
¶ separates the name and the commandline. ¶ is ANSI-char 182.
If one "%" is placed first in the commandline, the name of the file
that has focus will be sent as the last parameter to the program.
Two "%" will send the directory which contains the clicked file.
<Path to a file> is a path to a directory, document or program.
?<flags> is optional flags and switches to the program identified by
<Path to file>. Everything after the "?" will be sent as flags.
Do you get any of this? See further down for examples on how it 
works. :)

5. Special commands
-------------------
These names are reserved. Avoid creating any keys with a leading "[".
They are sort of "reserved" for future use.
 [copypath]
  Displays the full path to the file. Clicking this item copies the 
  path to the clipboard. If several files are selected, the names will
  be copied to the clipboard delimited by new lines.
 [stamp]¶<0|1 0|1 0|1>
  Timestamps the creation-, write- and accesstimes of the file to
  current time. 0 leaves time unaffected. No support for several files.
  (For instance, "010" only changes the writetime.)
 [props]¶
  Displays the files attributes and size in bytes. Clicking the
  item copies the line to the clipboard. No support for several files.
 [copy]¶<Path>  
  Copies the selected file(s) to the folder named in <Path>.
 [move]¶<Path>
  Same as [copy], but the original file(s) is deleted. No recycle-bin
  involved.
 [copyfolder]¶
  Opens a standard dialogbox to let you select a folder. The clicked
  file(s) will then be copied into that folder.
 [movefolder]¶
  Same as [copyfolder], but the original file(s) is deleted.

6. Q&A
------
Some questions one might have...
Q: Registry, keys, [, %, ?... I don't get it. Isn't there any editor
   to do this?
A: Yes, cmexted.exe is included in the archive-file.
Q: I want to do something that requires function-calls to the WinAPI,
   or something else that can't be done with 'normal' programs and 
   shortcuts, kind of like [stamp]. What do I do?
A: Some options:
   a) You learn the basics of programming and write a VB-script. Then
      you link a menuitem to the script. ;)
   b) You learn more about programming and write a program for the
      specific task. :)
   c) You learn even more programming and write a shell-extender of 
      your own. :D
   d) You pay a little pile of money for a commercial context-menu-
      extender, made by someone else and providing the functionality
      you want. :\
      (There's a couple of them out there, some of them cost a bit and
       aren't as versatile as CMenuExtender. But on the other hand they
       might come with a user-friendly, reliable and fancy editor! ;)
   e) Why not try writing a good old .bat-file?
   f) You evaluate if there might be a general need for the missing
      functionality, and if you find it to be so, write us a well-
      formulated, articulant and convincing mail, making us include 
      it in a new version.
Q: I installed CMenuExtender and now the Explorer is having a merry 
   little hell, crashing all the time. Uninstalling doesn't help. How
   do I get rid of this garbage?
A: Start Regedit and remove the key HKEY_CLASSES_ROOT\*\shellex\
   ContextMenuHandlers\CMenuExtender. That should help.
Q: What are all the other wierd keys found under "Contents" for?
A: Just some info that was used when executing the last command. You
   don't have to bother about them. Unless you write a script to per-
   form some specific task, in which case you might want to use the
   information. See further down for more info.
Q: How do I find the character ¶?
A: Hold down ALT, press "0182" and release the ALT-key.
Q: I hacked a little and now a blank menuitem appears in the context-
   menu. When I click it, the Explorer crashes. Like, help...
A: There's not supposed to be any registryvalue assigned to the 
   default-value of a subkey. If there is, you have to remove it, 
   otherwise CMenuExtender can't find a commandline to execute.

7. Contact
----------
If you find something that might be a bug, please contact us. But make
sure that it really is something with CMenuExtender that is causing the
problem and not a comma or slash in the wrong place in the registry.
If you find any errors (or spelling mistakes :) in this document, or if
you think that something mentioned here could deserve some further 
attention, let us know.

revenger_inc@hotmail.com

8. Examples 
-----------
For your copying plesures. Pretty many examples, we got a bit carried
away. :) These are commandlines for the registrykeys. The name of the 
keys are not important.

"View in Notepad¶%C:\WINDOWS\Notepad.exe"
 Opens the file in Notepad. Installed automatically.

"Print as text¶%C:\WINDOWS\Notepad.exe?/p"
 Prints the file using Notepad.

"[copy]¶C:\My documents"
 Copies the file to My documents.

"My documents¶C:\My documents"
 Opens the folder My documents.

"A file I often open¶C:\My documents\Important.doc"
 Opens the file in MS Word, if you have MS Word, and .doc extensions
 are registered for Word. Works for all registered extensions.

"Change into My Docs¶C:\WINDOWS\Explorer.exe?/e,C:\My documents"
 Changes the explorer into the My documents-folder, or if used in a 
 non-explorer-style window, starts a new explorer with My documents
 opened.

"Explore here¶%%C:\WINDOWS\Explorer.exe?/e,"
 Opens an explorer in the current directory, if used in a non-explorer-
 style window. If used in explorer, it updates the current directory.
 (Can be nice if you want to open the directory of a file after having
  used the searchfunctions.)

"Dos¶%%C:\WINDOWS\Command.com?/k cd "
 Opens a dosprompt and changes into the current directory.

"Microsoft.com¶http://www.microsoft.com"
 Opens the default browser and goes to www.microsoft.com. If you want
 to use another browser than the default, you make a regular shortcut.

"Mail Revenger¶mailto:revenger_inc@hotmail.com"
 Creates a new e-mail for revenger_inc@hotmail.com, using the default
 mailprogram.

When making your own shortcuts, it will help knowing a bit about how
your programs uses commandline-interface.

Some info that might be handy if you write scripts:
All keys are found under HKCU\Software\Revenger inc.\CMenuExtender.

"attribSt":
 The string displayed by [props]. Contains the filesize.
"commandLine":
 The commandline string used when executing the last action.
"commandName":
 The name of the last executed command. Can be a special command.
"SFileName":
 The name of the file that called the contextmenu. If this key is "*",
 several files were selected. The names of the files are found as keys
 under the subkey "fileNames".

CMenuExtender uses the ShellExecute-function to execute all commands.