home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util1 / incx100b.lzh / INC-PROG.LZH / HELP.LZH / MCV.HLP < prev    next >
Text File  |  1991-02-26  |  12KB  |  180 lines
  1. mcv
  2.  Help information about: Views
  3.  ^Editing
  4.  
  5.               E╔════════════════════════════════════════════════╗
  6.               E║                     CViewsE                      ║
  7.               E╚════════════════════════════════════════════════╝
  8.  
  9.  
  10.  ZmccB  If you have not already read the help text dealing with CJ Classes CB, you
  11.    should do so before reading this material on Views.
  12.  
  13.  CWhat Are Views?
  14.  
  15.    While it is often convenient to focus on a small set of objects by
  16.    selecting a CClassB, that is sometimes too narrow a focus.  InContext
  17.    allows you to define CViewsB, each of which consists of a group of
  18.    object classes.  By selecting a view, you focus on one or more classes.
  19.  
  20.    For example, a "document" view might include objects of the "doc", "txt",
  21.    and "ltr" classes, if those happen to be your class names for "document",
  22.    "text", and "letter".  A "graphic" view might include pictures in several
  23.    different image formats, such as "img", "pcx", etc.
  24.  
  25.    This can be helpful for a couple of reasons:
  26.  
  27.         CB You may remember that you're looking for, say, a document, but
  28.           not remember exactly what type it is.  By selecting the "document"
  29.           view, you can focus quickly on the set of objects most likely to
  30.           include the one you're looking for.
  31.  
  32.         CB Just as it is possible to invoke some programs on all objects
  33.           in a single class, it is sometimes appropriate to invoke a program
  34.           on all objects in a view.  For example, a programmer using C and
  35.           assembler might define a "program", or "source" view as including
  36.           the classes "c", "h", "asm", and "mk".  By invoking a text editor
  37.           (such as Brief) on this view, he could edit all the source modules
  38.           in a software package in one editor session, moving among them at
  39.           will.
  40.  
  41.    Selection of views operates in the same fashion as selecting Classes.  You
  42.    can select a view from the EViewsB section of the main display or by
  43.    invoking the F VDiews B command from the command bar.  Doing the latter
  44.    results in a display such as the following.
  45.  
  46.                 E▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  47.                 E█A                                          A  E█
  48.                 E█A  B E│B                                    E│B A  E█
  49.                 E█A  B E│B  EViewsB  EClassB   EObjectsB   EActionsB  E│B A  E█
  50.                 E█A  B E│B ALL      CALLB     edit.c   view-all E│B A  E█
  51.                 E█A  B E│B archive  asm     test.c   editYB-all E│B A  E█
  52.                 E█A  B E│B chess    c    hrredit.h   del-all  E│B A  E█
  53.                 E█A  B E│B document h    hrredit.mk  arc-all  E│B A  E█
  54.                 E█A  B E│B execable mk                        E│B A  E█
  55.                 E█A  B E│B finance                            E│B A  E█
  56.                 E█A  B E│B fonts                              E│B A  E█
  57.                 E█A  B E│B graphic                            E│B A  E█
  58.                 E█A  B E│B incontxt                           E│B A  E█
  59.                 E█A  B E│B letters                            E│B A  E█
  60.                 E█A  B E│B messages                           E│B A  E█
  61.                 E█A  B E│B Csource  B                           E│B A  E█
  62.                 E█A  B E│B tapcis                             E│B A  E█
  63.                 E█A  B E│B ventura                            E│B A  E█
  64.                 E█A  B E│B xref                               E│B A  E█
  65.                 E█A                                          A  E█
  66.                 E▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  67.  
  68.    As you can see, the "source " view has been selected.  The EClassB list
  69.    shows how this view is defined.  It includes the classes "asm", "c", "h",
  70.    and "mk".  You can also see that there are no objects of class "asm" in
  71.    this directory, but there are examples of the other three.  This user has
  72.    an editor that allows multiple-file editing, and has therefore defined an
  73.    "edit-all" action applicable to whole views and classes.  If the action
  74.    "edit-all" is selected, the user's editor will be invoked on the four
  75.    objects in the current view.
  76. mcve
  77.  Help information about: Editing the Views Display
  78.  
  79.  
  80.               E╔════════════════════════════════════════════════╗
  81.               E║           CEditing the Views DisplayE            ║
  82.               E╚════════════════════════════════════════════════╝
  83.  
  84.  
  85.    The CViewsB capability is only really useful if you can define your own
  86.    views.  To do so, you need to "Edit" the Views display.  Start by
  87.    selecting the F VDiews B command, which will produce a display like the
  88.    following.
  89.  
  90.         E▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  91.         E█A                                                          A  E█
  92.         E█A  Cxt Artifacts -- incontxt                           B1/29/A  E█
  93.         E█A  Eiew:B CALL     B  EClass:B ChlpB   EObject:B C            B   ETask:A  E█
  94.         E█A  C       G  View  C                                         A  E█
  95.         E█A  B   G                                FªEDdYDit     FªHDelpG  B    A  E█
  96.         E█A  Eour│B                                               E│A  B ESA  E█
  97.         E█A  E ..│B EBrief NameB     EYour DescriptionB               E│A  B  A  E█
  98.         E█A  E ..│B  CALL     B     CAll object classes            B  E│At B  A  E█
  99.         E█A  E ..│B  archive      Archive files                   E│A  B  A  E█
  100.         E█A  E ..│B  chess        Chess games                     E│A  B  A  E█
  101.         E█A  E ..│B  document     Document preparation view       E│A  B  A  E█
  102.         E█A  E ..│B  execable     Executable programs             E│A  B  A  E█
  103.         E█A                                                          A  E█
  104.         E▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  105.  
  106.    This display shows you what views are available, by name and description.
  107.    If you want to add, change, or delete a view definition, simply select
  108.    the F EDdit B command, as shown above.  The display will change to
  109.    indicate that the name and description fields are editable, as shown
  110.    below.
  111.  
  112.         E▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  113.         E█A                                                          A  E█
  114.         E█A  Cxt Artifacts -- incontxt                           B1/29/A  E█
  115.         E█A  Eiew:B CALL     B  EClass:B ChlpB   EObject:B C            B   ETask:A  E█
  116.         E█A  C       G  View  C                                         A  E█
  117.         E█A  B   G  Editing View Definitions                FªHDelpG  B    A  E█
  118.         E█A  Eour│B                                               E│A  B ESA  E█
  119.         E█A  E ..│B EBrief NameB     EYour DescriptionB               E│A  B  A  E█
  120.         E█A  E ..│B  IALL     B     IAll object classes            B  E│At B  A  E█
  121.         E█A  E ..│B  Iarchive B     IArchive files                 B  E│A  B  A  E█
  122.         E█A  E ..│B  Ichess   B     IChess games                   B  E│A  B  A  E█
  123.         E█A  E ..│B  IdocYIumentB     IDocument preparation view     B  E│A  B  A  E█
  124.         E█A  E ..│B  IexecableB     IExecutable programs           B  E│A  B  A  E█
  125.         E█A  Ep..│B  Ifinance B     IFinancial management view     B  E│Ag B  A  E█
  126.         E█A  E ..│B  Ifonts   B     ILaser printer fonts           B  E│A  B  A  E█
  127.         E█A  C E..│B  Igraphic B     IGraphical objects             B  E│A  B  A  E█
  128.         E█A  E CwwE│B  IincontxtB     IInContext control artifacts   B  E│A  B  A  E█
  129.         E█A  E CwwE│B  Iletters B     ILetters on various letterhead B  E│Al B  A  E█
  130.         E█A  E C..E│B  ImessagesB     ICompuServe messages           B  E│A  B  A  E█
  131.         E█A  E C..E│B  Iprogram B     ISource programming view       B  E│Al B  A  E█
  132.         E█A  E C..E│B  Isystem  B     INon-executable system files   B  E│Ae B  A  E█
  133.         E█A  E C..E│B  Itapcis  B     ICIS- and TAPCIS-related stuff B  E│A  B  A  E█
  134.         E█A  E C..E│B  Iventura B     IVentura Publisher artifacts   B  E│A  B  A  E█
  135.         E█A  E CnnE│B  Ixref    B     ICross-references, maps, etc.  B  E│Ad B  A  E█
  136.         E█A  E C..E└───────────────────────────────────────────────┘A  B  A  E█
  137.         E█A  Eudy RAamsey ──────────────────── Mode: Work ──────── DiEskA  E█
  138.         E█A                                                          A  E█
  139.         E▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  140.  
  141.    The fields displayed like this: IdocumentB are editable fields.  This
  142.    means that you can place the cursor in them and insert, delete, or replace
  143.    characters at will.  You may be able to do this without further help, if
  144.    you are an experienced computer user.  If you need more information about
  145.  ZmeB  using the editing features of InContext, see CJ Editing in InContext CB.
  146.  
  147.    Each view has a "Brief Name", a "Description", and a "definition".  You
  148.    can see the first and second of these in the display above, but the third
  149.    is hidden.  To see (and edit) the view definition, you need to place the
  150.    cursor on the line whose definition you want (e.g., "IdocumentB" above),
  151.    and press either function key CF2B (the "edit" key) or the Cleft mouse
  152.    CbuttonB.
  153.  
  154.    For example, the figure below shows a possible definition of the "document"
  155.    view.  It indicates that the "document" view includes all objects of the
  156.    "doc", "fmt", "lab", "ltr", "ris", and "txt" classes.  If you choose to
  157.    have a "document" view, you will almost certainly want a different set of
  158.    classes included.  By editing the definition to include your own list of
  159.    classes, you define the view.  
  160.  
  161.               E▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  162.               E█A                                              A  E█
  163.               E█A  B EDrive:B CcB   EView:B CALL     B  EClass:B ChlpB   EObjA  E█
  164.               E█A  H Space  Time  Plans G  View  HClass  Object  AA  E█
  165.               E█A  E│B               G  Editing View Definitions  A  E█
  166.               E█A  G  Editing Definition of "document"          A  E█
  167.               E█A  E│YBdocE                                        A  E█
  168.               E█A  E│BfmtE                                        A  E█
  169.               E█A  E│BlabE                                        A  E█
  170.               E█A  E│BltrE                                        A  E█
  171.               E█A  E│BrisE                                        A  E█
  172.               E█A  E│BtxtE                                        A  E█
  173.               E█A  E│B   E                                        A  E█
  174.               E█A                                              A  E█
  175.               E▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  176.  
  177.    View definitions are editing using the ordinary InContext text editor.
  178.    You should make sure that each class is named on a separate line, and
  179.    that you include only the 1-3 character class name on the line.
  180.