home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / HYPERBOOK2.DMS / in.adf / hbk / text < prev    next >
Encoding:
Text File  |  1990-03-29  |  1.4 KB  |  29 lines
  1. Page, object and list item numbers
  2.  
  3. Any page, object or item can be uniquely specified with a construct called an
  4. object number - objnum for short - which is actually a specially
  5. formatted string of digits and punctuation. Most commands use the object
  6. number to control which page, object or list item is affected. In some
  7. respects, the object number is like an AmigaDOS path name, consisting of
  8. specifiers separated by punctuation symbols to refer to `volumes' (pages),
  9. `directories' (groups or lists) and `files' (object or items).
  10.  
  11. One important difference between objnums and path names is that there is no
  12. such thing as a group-relative or list-relative object number to correspond
  13. to a CD-relative path name: you can't refer to an object without also
  14. specifying its parent group(s), if applicable, or refer to a list item
  15. without also specifying its parent list. There is such a thing as the
  16. `current page', which can be referenced by omitting the page number in an
  17. object number (a colon is still required; see the syntax line below).
  18.  
  19. The form of an object number is:
  20.  
  21.    [page]:[[group/]...[group/]]object | list/item
  22.  
  23. The Bin is referred to in objnums using the special page number 0.
  24.  
  25. In practice, the detailed construction of an objnum is not very often of
  26. interest when writing scripts: normally, one can obtain and use objnums in
  27. the same way as one uses AmigaDOS file handles, without reference to their
  28. internal structure.
  29.