Return to Xd.1c CVS log

Up to [CSRG BSD Unix] / 43BSDReno / contrib / isode-beta / others / quipu / uips / xd

Annotation of 43BSDReno/contrib/isode-beta/others/quipu/uips/xd/Xd.1c, revision 1.1

1.1     ! root        1: .\" $Header: /f/osi/others/quipu/uips/xd/RCS/Xd.1c,v 7.0 90/06/12 13:11:52 mrose Exp $
        !             2: .TH XD 1C "2 Mar 1990"
        !             3: .SH NAME
        !             4: xd \- X windows directory user agent.
        !             5: .SH SYNOPSIS
        !             6: .B xd
        !             7: .SH DESCRIPTION
        !             8: .PP
        !             9: The \fIxd\fR program implements a simple window interface to
        !            10: an X500 OSI directory.
        !            11: It is very distantly related to an interface called "widget".
        !            12: .PP
        !            13: 
        !            14: \fIXd\fR runs under X and provides a `push-button',
        !            15: mouse-driven interface suitable for novice users.
        !            16: Functions are invoked by clicking mouse button 1 (usually the
        !            17: left most button) on the relevant button shape. 
        !            18: .PP
        !            19: Searches within the directory are conducted relative
        !            20: to an area displayed in the \fISearch Area\fR widget.
        !            21: An instance of this could be,
        !            22: .sp
        !            23: .in +.5i
        !            24: .nf
        !            25: \*(lqGB, Brunel University.\*(rq
        !            26: .fi
        !            27: .in -.5i
        !            28: .sp
        !            29: A search is performed on the basis of
        !            30: a search value 
        !            31: (or attribute)
        !            32: which describes some aspect of the
        !            33: object 
        !            34: (i.e. it's name,
        !            35: location etc.)
        !            36: and a type,
        !            37: which associates the object being searched
        !            38: for with one of a given set of types
        !            39: (i.e. Person, Place, Organization, Department).
        !            40: The search value is displayed in the \fISearch For\fR field
        !            41: and it's type is shown in the \fIType\fR field.
        !            42: Any search will return a list of objects that match
        !            43: the given search value within the current search area.
        !            44: To display information on or move to a listed object, point 
        !            45: at the object in the list area and click button 1.
        !            46: .SH OPTIONS
        !            47: .PP
        !            48: The usual X command line parameters can
        !            49: be passed to xd.  Typically these might be:
        !            50: 
        !            51: .TP 2i
        !            52: -display display
        !            53: This option specifies the name of the  X  server  to
        !            54: use.
        !            55: 
        !            56: .TP 2i
        !            57: -geometry geometry
        !            58: This option specifies the initial size and  location
        !            59: of the window.
        !            60: 
        !            61: .PP
        !            62: These and other X options are described in X(1).
        !            63: .bp
        !            64: .PP
        !            65: The following options relate to the quipu directory services.
        !            66: 
        !            67: .TP 2i
        !            68: -t tailor file
        !            69: 
        !            70: .TP 2i
        !            71: -c dsa name
        !            72: 
        !            73: .TP 2i
        !            74: -T oid table
        !            75: 
        !            76: .TP 2i
        !            77: -D directory
        !            78: 
        !            79: 
        !            80: .SH EXAMPLES
        !            81: .PP
        !            82: An example of a simple search is shown below.
        !            83: Here the target is the directory object for
        !            84: \*(lqProfessor Polonius Plum\*(rq
        !            85: of Brunel University.
        !            86: The search is initiated with
        !            87: the search area set to \*(lqGB, Brunel University.\*(rq,
        !            88: a value \*(lqPlum\*(rq and type \*(lqPerson\*(rq,
        !            89: with the directory then returning,
        !            90: .sp
        !            91: .in +.5i
        !            92: .nf
        !            93: Computer Science, Polonius Plum
        !            94: .br
        !            95: Law, Plumley Farquarson
        !            96: .fi
        !            97: .in -.5i
        !            98: .sp
        !            99: Subsequently clicking on P Plum  would then give,
        !           100: .sp
        !           101: .in +.5i
        !           102: .nf
        !           103: commonName      - Polonius Plum
        !           104: .br
        !           105: surname         - Plum
        !           106: .br
        !           107: userClass       - staff
        !           108: .br
        !           109: rfc822Mailbox   - [email protected]
        !           110: .br
        !           111: description     - "ruddy faced and gat toothed"
        !           112: .fi
        !           113: .in -.5i
        !           114: .PP
        !           115: A standard search strategy in \fIxd\fR,
        !           116: and most other directory interfaces,
        !           117: is to move to a suitable search area,
        !           118: i.e. an \*(lqarea\*(rq in which the real world object is contained,
        !           119: and to then search using an appropriate value and type.
        !           120: .PP
        !           121: The action of various objects in the xd interface is described below: 
        !           122: 
        !           123: .TP 2i
        !           124: Quit
        !           125: Exit Xd
        !           126: 
        !           127: .TP 2i
        !           128: Help
        !           129: This provides a help
        !           130: window which gives
        !           131: help on the  action
        !           132: related to the current
        !           133: position of the pointer
        !           134: 
        !           135: .TP 2i
        !           136: Search Area
        !           137: Current position
        !           138: 
        !           139: .TP 2i
        !           140: Search For
        !           141: Search string entry field
        !           142: 
        !           143: .TP 2i
        !           144: Type
        !           145: Search data type selection
        !           146: 
        !           147: .TP 2i
        !           148: Read Area
        !           149: The read area shows the result of
        !           150: a read on an object.  Error messages
        !           151: and other progress messages are
        !           152: also shown in this window.
        !           153: 
        !           154: .TP 2i
        !           155: Search
        !           156: Begin search for data in the 
        !           157: Search For field
        !           158: 
        !           159: .TP 2i
        !           160: List
        !           161: The List function returns all entries
        !           162: immediately subordinate to the entry
        !           163: specified as the current position. The
        !           164: maximum size  of the resulting list will
        !           165: normally be limited to fifty, thus the
        !           166: value of a call to List is  limited  if
        !           167: searching for a specific directory entry.
        !           168: 
        !           169: If the mouse button is pressed
        !           170: to select an item from the list
        !           171: window, that item becomes highlighted
        !           172: and becomes the current
        !           173: search area.  A read of any
        !           174: information held about that
        !           175: item is also performed and the
        !           176: result is shown in the Read
        !           177: window.
        !           178: 
        !           179: 
        !           180: .TP 2i
        !           181: Look back
        !           182: Lookback enables you to jump back to
        !           183: the 10 places you most recently
        !           184: selected from the list window.
        !           185: 
        !           186: .TP 2i
        !           187: Widen
        !           188: Push button to put you back
        !           189: one step. This allows you to
        !           190: backtrack if you have gone to
        !           191: a wrong location.
        !           192: 
        !           193: .TP 2i
        !           194: List Area
        !           195: The result of a list or search action is
        !           196: shown in the list window.
        !           197: 
        !           198: .PP
        !           199: In order to make \fIxd\fR simple to understand
        !           200: there are no facilities for modifying entries.
        !           201: .bp
        !           202: .SH "SEE ALSO"
        !           203: dish(1c) sd(1c) pod(1c) X(1)
        !           204: .br
        !           205: \fIThe ISO Development Environment: User's Manual, Volume 5: QUIPU\fR
        !           206: .br
        !           207: ISO 9594:
        !           208: \fIInformation Processing \-\- Open Systems Interconnection \-\-
        !           209: The Directory\fR
        !           210: .SH AUTHOR
        !           211: [email protected]
        !           212: .br
        !           213: [email protected]
        !           214: .br
        !           215: [email protected]

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.