; Command syntax used in this file ; ; PATTERN/K,EXECUTABLE/K,COMMAND/K,EXPLAIN/K,DEEP/N,CONFIG/K,PANE/K,SLIDERWIDTH/N,HOVER/K,PROTECTED/K ; ; Global options (for all panes): ; ; CONFIG/K Configuration file to be read (STRING) ; FONT/K Font name, e.g. "topaz.font" (STRING) ; SIZE/N Font size (NUMBER) ; PROTECTED/K Make pattern gadget read-only ? (BOOL) ; DEEP/N Depth of subdirectories to be scanned (NUMBER) ; HOVER/K Show hover effect ? (BOOL) ; SLIDERWIDTH/N Slider size (NUMBER) ; ; Options for pane configuration: ; ; PANE/K Label of tab gadget (STRING) ; PATTERN/K DOS File pattern (STRING) ; EXECUTABLE/K DOS file pattern specifying the "clickable" files (STRING) ; COMMAND/K Command to be executed if the user clicks on a "clickable" file (STRING) ; EXPLAIN/K Command to be executed if the user clicks on other files or clicks with ; EXAMINE/S Display additional information (file title) ; SHORTNAME/S Hide file suffix ; ; Placeholders in command strings ; ; The first %s in command strings (COMMAND/K and EXPLAIN/K) is replaced with ; the full path of the file the user has selected. The second %s is replaced ; with the file name of the selected file relative to the root directory. You ; can use %.0s anywhere in the command string to skip the first %s (this is a ; formatting command setting the output length to 0, it produces "nothing"). ; ; Using quotes and the asterisk character in this file ; ; All lines in this file are parsed by the OS function ReadArgs() when the ; Explorer plug-in reads the configuration. This function designates a special ; meaning to the * character: while quotes normally are used as string ; delimiter, a quote with a preceding asterisk (*") is "the quote character". ; A n with a preceding asterisk (*n) is "the linefeed character". And an ; asterisk with a preceding asterisk (**) is "the asterisk character". That's ; why you find pattern strings of the form **.xyz in this file: the plug-in ; actually sees this as *.xyz ! ; ; Things get a bit complicated for the arguments following after the COMMAND/K ; and EXPLAIN/K options: GoldED uses another ReadArgs() pass to process ; incoming command strings. Consequently, you have to be very careful with ; using quotes in commands: replace all * with ** and all quotes with *" (quote ; with a preceding asterisk) to prepare for parsing by the Explorer plug-in. ; Having done this, repeat this step one more time to prepare for parsing by ; the editor (use the editor's search-replace reqester for these steps if you ; find it too confusing). ; PROTECTED=TRUE DEEP=0 PANE="Header" PATTERN="**.(h|hh|hpp|hhp|h++)" EXECUTABLE="~(**.o)" COMMAND="WINDOW FORCE USE *"%s*"" EXPLAIN="OPEN NAME *"%s*"" PANE="Sources" PATTERN="**.(c|cc|cpp|ccp|c++|asm|a)" EXECUTABLE="~(**.o)" COMMAND="WINDOW FORCE USE *"%s*"" EXPLAIN="OPEN NAME *"%s*""