WWWWAAAAIIIISSSSQQQQ((((1111))))       TTTThhhhiiiinnnnkkkkiiiinnnngggg MMMMaaaacccchhhhiiiinnnneeeessss ((((TTTThhhhuuuu FFFFeeeebbbb 22220000 1111999999992222))))       WWWWAAAAIIIISSSSQQQQ((((1111))))



     NNNNAAAAMMMMEEEE
          waisq

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
          This is a shell level interface to WAIS questions that have
          been built using xwais.  It allows a user to submit
          questions to sources for queries, and to retrieve documents
          from questions (and the appropriate source).  It can build
          or modify a question, including the modification performed
          during a search.

     UUUUSSSSAAAAGGGGEEEE
          wwwwaaaaiiiissssqqqq
            [-f question_file] /* defaults to stdin, stdout */
            [-s sourcedir] /* or ~/wais-sources/ */
            [-S sourcename]
            [-c common_sourcedir] /* or it is ignored */
            [-m max_Result_Docs] /* defaults to 40 */
            [-v document_number]
            [-g] /* to do a search */
            [-h] /* this message */
            [-t] /* test a source */
            [-V] /* print version */
            [word [word [...]]]
          or

           wwwwaaaaiiiissssqqqq - [other options] /* for interactive mode */

     OOOOPPPPTTTTIIIIOOOONNNNSSSS
          ----ffff question_filename
                    the pathname for a question structure as stored in
                    a file.  It uses standard UNIX conventions.  If no
                    filename is provided, stdin is used.  If the
                    filename is a dash ( - ), no question will be
                    read, so you must specify a sourcename and the
                    words to search.  This will create a question
                    structure and write it to stdout.


          ----ssss sourcedir
                    a directory where source structures are stored.
                    It must end with a '/'.  If it is not specified,
                    ~/wais-sources/ is used.  If none of those exist,
                    the application will probably fail, unless the
                    common_sourcedir exists.  Only files that end in
                    .src in the directory are considered sources.

          ----SSSS sourcename
                    the pathname of a source structure file.  It must
                    exist in sourcedir or common_sourcedir, and end in
                    .src




     Page 1                                           (printed 8/6/92)






     WWWWAAAAIIIISSSSQQQQ((((1111))))       TTTThhhhiiiinnnnkkkkiiiinnnngggg MMMMaaaacccchhhhiiiinnnneeeessss ((((TTTThhhhuuuu FFFFeeeebbbb 22220000 1111999999992222))))       WWWWAAAAIIIISSSSQQQQ((((1111))))



          ----cccc common_sourcedir
                    Similar to sourcedir, but usually common for a
                    site. It need not exist.

          ----mmmm maxDocs
                    The limit on the number of results returned by a
                    server.  Default value is 40.

          ----vvvv document_number
                    The number of the document to retrieve from a
                    valid query.  This can be from a previously stored
                    question, or the current question if the -g option
                    is used.

          ----tttt        Test a source to see if it is servicing wais
                    requests.  The first word will be taken as the
                    name of a source.

          ----gggg        Submit the query.  You must specify the -g option
                    in order to actually perform a query.  You need
                    not specify it if you have already performed a
                    query from which you wish to retrieve a document.

          ----VVVV        Print the version number and date of the program.

          wwwwoooorrrrdddd...   optional search keywords to replace any search
                    keywords in the question.

          ----         If the first argument is a dash ( - ) then waisq
                    operates in an interactive mode.  It then reads
                    question structures from standard input, and
                    returns results to standard output.  If the
                    question has search-words or relevant documents,
                    it performs the query, and returns the resulting
                    question structure to standard output.  If there
                    are only result documents, it retrieves them and
                    prints them to standard output.  It continues to
                    read it's input until an end of file is
                    encountered, and then it exits.  All other command
                    line switches will work, except -f.  This makes
                    waisq useful as a tool for user interfaces to
                    access the WAIS system.

     EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
          to create a new question and submit it for a query:
               waisq -f - -S sourcename -g word1 word2 > my_question

          to submit an existing question for query:
               waisq -f question_name -g

          To retrieve a response:
               waisq -f question_name -v 1



     Page 2                                           (printed 8/6/92)






     WWWWAAAAIIIISSSSQQQQ((((1111))))       TTTThhhhiiiinnnnkkkkiiiinnnngggg MMMMaaaacccchhhhiiiinnnneeeessss ((((TTTThhhhuuuu FFFFeeeebbbb 22220000 1111999999992222))))       WWWWAAAAIIIISSSSQQQQ((((1111))))



     SSSSEEEEEEEE AAAALLLLSSSSOOOO
          waisserver(1), waisindex(1), waissearch(1), xwais(1),
          xwaisq(1)

          Wide Area Information Servers Concepts by Brewster Kahle.
          brewster@think.com


     DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
          The diagnostics produced by the application are meant to be
          self-explanatory.


     BBBBUUUUGGGGSSSS
     AAAAUUUUTTTTHHHHOOOORRRR
          Jonny Goldman <Jonathan@Think.COM>







































     Page 3                                           (printed 8/6/92)