Provided by: pythoncard-tools_0.8.2-5_all bug


       findfiles - Utility to locate files containing specific content


       findfiles [switches]


       Very  often when you are programming in any programming or scripting language, you want to
       find out how a particular function works or whether a particular property is settable,  or
       any  of  a  number  of  other  questions.  In many cases, you can find the answers to your
       questions by looking at the source code of the application or tool you're using.  This  is
       sometimes  referred  to as "code shopping," particularly when what you really hope to find
       is a method that does exactly what you want to  do.   The  PythonCard  findfiles  tool  is
       designed to support you in these efforts.

       Type  in  a  string for which to search, tell findfiles the directories (yes, you can have
       more than one) in which to search for files containing that string, and send findfiles off
       to locate files with that specific content.  Scroll through the list of files, each with a
       line reproducing part of the located line for each occurrence in the file,  find  the  one
       you  think  is  what you are looking for, and double-click the line. Voila! The PythonCard
       codeEditor tool opens and scrolls instantly to the line you've selected.


       -p     Show property editor

       -m     Show message watcher

       -l     Enable logging

       -s     Show shell

       -m     Show namespace

       -d     Show debug menu


       The findfiles utility uses classic Unix grep (regular expression) searches.

       The  grep  utility  uses  a  technique  called  regular  expression  matching  to   locate
       information.  In  regular expressions, some characters have a special meaning. If you want
       to search for any of these special characters in the  strings  you  supply  in  findfiles,
       you'll have to escape them by preceding them with a backward slash (\) character.

       While  there are many such characters in regular expressions, the ones with which you will
       need to be most careful are:  question  mark  (?),  asterisk  (*),  addition/concatenation
       operator  (+),  pipe  or  vertical bar (|), caret (^) and dollar sign ($). To search for a
       dollar sign in the target directories, for  example,  put  "\$"  into  the  search  field.
       (Putting in a $ by itself will crash findfiles fairly reliably.)

       On  a Debian system, you can see the manpages for grep(1) or regex(7) for more information
       on grep and regular expressions.


       The findfiles utility also provides additional functionality that is not discussed in this
       manpage, because it is somewhat difficult to completely describe usage of a GUI program in
       a text-based manpage.  For more detailed usage instructions or for more information on the
       PythonCard  GUI  framework  in  general, you should install the pythoncard-doc package and
       take a look at the various walk-throughs, tutorials and samples included with it.

       Once  the  pythoncard-doc  package  is  installed,  the  documentation  is  installed   to
       /usr/share/doc/pythoncard-doc,  and is also available via Debian's doc-base infrastructure
       - find it in the Devel section using dwww(1), doc-central(1) or dhelp(1).

       If you would rather not install the pythoncard-doc package, you can find  essentially  the
       same information on the PythonCard website:


       Although it is considered to be stable, this is still development-level software.

       Please  report  bugs in this or any PythonCard component to the Debian Bug Tracking system
       using reportbug(1).


       This manpage was written by Kenneth J. Pronovici <>,  for  use  by  the
       Debian  project.   Content  was  based  on previously-existing PythonCard documentation in
       other forms.


       codeEditor(1), resourceEditor(1),