Category : Communication (modem) tools and utilities
Archive   : HSLT102B.ZIP
Filename : HSLTAG.DOC

 
Output of file : HSLTAG.DOC contained in archive : HSLT102B.ZIP



ÚÄÄÄ¿ ÚÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄ¿
³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³
³ ³ ³ ³ ³ ÚÄÄÄÄÄÙ ³ ³ ÀÄÄÄ¿ ÚÄÄÄÙ ³ ÚÄÄ¿ ³ ³ ÚÄÄÄÄÄÙ
³ ³ ³ ³ ³ ÀÄÄÄÄÄ¿ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³
³ ÀÄÄÄÙ ³ ³ ³ ³ ³ ³ ³ ³ ÀÄÄÙ ³ ³ ³
³ ÚÄÄÄ¿ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ÚÄÄÄÄ¿
³ ³ ³ ³ ÀÄÄÄÄÄ¿ ³ ³ ³ ³ ³ ³ ÚÄÄ¿ ³ ³ ³ ÀÄ¿ ³
³ ³ ³ ³ ÚÄÄÄÄÄÙ ³ ³ ÀÄÄÄÄÄ¿ ³ ³ ³ ³ ³ ³ ³ ÀÄÄÄÙ ³
³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³
ÀÄÄÄÙ ÀÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÙ ÀÄÄÄÙ ÀÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÙ




HSLTAG v1.00 Beta
Copyright (C) 1993 Thomas P. Hansen
All Rights Reserved.

HSLTAG is a file tagging and batch upload manager for use as a shell from
the communications program of choice for managing BBS bidirectional trans-
fers with HS/Link (C) by Samual P. Smith. It allows for the creation of
description files with its internal editing features and will place these
description files in compressed files which you have tagged for uploading.
Currently HSLTAG is compatible with ZIP, ZOO, PAK, ARC, LZH and ARJ com-
pression formats. It is stable and reliable in DOS, DESQview and Windows
environments.

HSL/tag is not just another file tagger. It contains all the necessary
features for preparing your uploads while off line so that you may exe-
cute your bidirectional transfer with a single keystroke while on your
favorite BBS. It's file description capabilities are compatible with
FILE_ID.DIZ, DESC.SDI and DOZ formats. The DOZ format is the new descrip-
tion format used by the RBATCH (C), the batch upload handler for RBBS-PC
by Dan Shore of the Shoreline BBS.

This program is not free! You are hereby licensed to use this program for
a trial period of 30 days free of charge. If, after 30 days, you decide
that you would like to continue using HSLTAG, you must complete the regis-
tration form (REGISTER.DOC) and return it to the author with the required
registration fee enclosed.

Registration removes the "UNREGISTERED" and "PLEASE REGISTER" messages, as
well as any time delays.

Please feel free to distribute HSLTAG to your friends and local BBSes as
long as all of the files in this archive are included and unmodified.

See the LICENSE AND REGISTRATION section of this document for more details.









HSLTAG 1.0 User Documentation - 1 -









Table of Contents


_________________________________________________________________

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Screen Display . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

File List Management . . . . . . . . . . . . . . . . . . . . . . . . 3

File Description Utilities . . . . . . . . . . . . . . . . . . . . . 4

Online HotKeys . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

HSLTAG Configuration Options . . . . . . . . . . . . . . . . . . . 7

Calling HSLTAG from COMM programs . . . . . . . . . . . . . . . . . 8

Trouble Shooting (Some HS/Link Windows 3.x problems). . . . . . . . . 9

External Utilities . . . . . . . . . . . . . . . . . . . . . . . . . 10

Liscense / Registration information . . . . . . . . . . . . . . . . . 11

Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11


























HSLTAG 1.0 User Documentation - 2 -




HSLTAG is a friendly environment built purposefully to match the
default color scheme of HSLINK. It's menu is boxed into four
sections, File List Management, File Description Utilities, Online
Hotkeys & Configuration. The Keys crucial to your on line sessions
are in Black and Yellow in the black and yellow box. The other
boxes outline functions which can and should ideally be performed
before you dial out in preparation for your calling session. Once
on line and logged onto a BBS then all you need to do is tell the
system what it is you want from them by executing the download command
on the BBS. Once the system tells you it is ready to send you the
files, shell to HSLTAG and hit your F4 key and your bidirectional file
transfer will be on its way. Yes! It is as simple as that!

(Menu out line omitted for this persentation)

ÄÄÄÄÄÄÄÄÄ HSLTag v1.00 - Copyright 1993 - Thomas P. Hansen ÄÄÄÄÄÄÄÄÄÄÄ

ÚÄÄÄÄÄÄ File List Management ÄÄÄÄÄÄ¿
³ ³ É Online Hot/Key »
³ [T] Tag files for Uploading ³ º º
³ ³ º ESC = Exit º
³ [A] Add file to Tagged file List ³ º º
³ ³ º F2 = Shell º
³ [E] Edit File List ³ º º
³ ³ º F4 = HS/Link º
³ [K] Kill File List ³ º º
³ ³ ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

ÚÄÄÄÄ File Description Utilities ÄÄÄÄ¿ ÚÄÄÄ Configuration ÄÄÄÄ¿
³ ³ ³ ³
³ [F] Description - FILE_ID.DIZ ³ ³ ³
³ ³ ³ [C] Configure HS/Link ³
³ [S] Description - DESC.SDI ³ ³ ³
³ ³ ³ [H] Configure HSL/Tag ³
³ [O] RBBS style DOZ Descriptions ³ ³ ³
³ ³ ³ ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

File List Management:

HSLTAG's File list management is set up for the purpose of perparing
your uploads prior to logging on to your BBS of choice. Valuable
time is not sent tagging and managing your upload while the clock
ticks away. HSLTAG does not delete the tagged list when you exit and
has the kill option set for when you want to create a new list of
files to upload. This allows you to upload the same list of files to



HSLTAG 1.0 User Documentation - 3 -



several systems without having to retag them. The management commands
are in the upper left quadrant of the HSLTAG screen.

ÚÄÄÄÄÄÄ File List Management ÄÄÄÄÄÄ¿
³ ³
³ [T] Tag files for Uploading ³
³ ³
³ [A] Add file to Tagged file List ³
³ ³
³ [E] Edit File List ³
³ ³
³ [K] Kill File List ³
³ ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

T = Tag files for uploading. As each file is tagged there is a
check put next to the file name in the tagging window. You
may toggle a tag on or off. Once the files are tagged they
will be added to the list of files to send by pressing the
F10 key. ESC will escape without adding names to the list.

ÚÄ[þ]ÄÄÄÄÄÄÄÄÄHSL/Tag v1.00á - Directory ListerÄÄÄÄÄÄÄÄÄÄ[]Ä¿
³û !SBLAST.ZIP DCRD100.ZIP HS-PROD.ZIP PCB-NG.ZIP ³
³û #1KEENV.ZIP DEBTMG10.ZIP KILL150.ZIP PKZFX24C.ZIP³
³ #1MAJOR.ZIP DLFIND12.ZIP MEGAE206.ZIP û PROBB10.ZIP ³
³ AMW13.ZIP DSZX009.ZIP MLABEL25.ZIP PROBB24.ZIP ³
³ AN30.ZIP EBANK12.ZIP MORCN11B.ZIP PRODOR34.ZIP³
³ AS26.ZIP EFND100.ZIP MORDOR30.ZIP û PROE344.ZIP ³
³ ASTSPEAK.ZIP EVP101A.ZIP NETGUIDE.ZIP û PROEDT34.ZIP³
³ CAL14S24.ZIP EXECWSWP.ZIP NGCHR104.ZIP PROPCK30.ZIP³
³ CALLOUT.LOG EXPRES22.ZIP NMSOURCE.ZIP PRORBBS.ZIP ³
³ CHOOSCUR.ZIP FDLSTP10.ZIP NOSN100.ZIP PSP101.ZIP ³
³ CLEAN100.ZIP FV142.ZIP NSTAT10.ZIP QBWIN5.ZIP ³
³ DCF40.ZIP GAPPRO10.ZIP ONLINE.ZIP QNODE150.ZIP³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ PROPCK30.ZIP 30813 Mar 15,1991 2:38p ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

The higlighted file ( which can not be illustrated in this
text is displayed at the bottem of the tagger's screen with
the file size, date and time.

A = Add file to list for uploading. If you have a file on your
system which you would like to upload but do not want to
load the tagger you may add it to the list using this
option.

You will be presented with a boxed field to enter the full
path and file name.





HSLTAG 1.0 User Documentation - 4 -


ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ³
³ Enter Path and File to Add úúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúú ³
³ ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
If the correct path and filename are entered and HSLTAG
finds the file it will be added to your tagged file list.


E = Edit file list option allows you to manually edit your
tagged file list using the editor you named in your HSLTAG
setup. Any text editor will work for this that does not
put control characters in the text. Dos 5.0's EDIT.COM or
QEdit are good editors for this purpose.

K = Kill File list will do just that. It will delete your
tagged file list so you may start a new one.

File Description Utilities

These options allow you to enter descriptions in the ZIP files you are
tagging to send if they do not already have description files in them.
The menu has three options which will allow you to enter a
FILE_ID.DIZ, DESC.SDI or DOZ description for the tagged file(s). The
options are found in the bottom left quadrant of the HSLTAG menu.



ÚÄÄÄÄ File Description Utilities ÄÄÄÄ¿
³ ³
³ [F] Description - FILE_ID.DIZ ³
³ ³
³ [S] Description - DESC.SDI ³
³ ³
³ [O] RBBS style DOZ Descriptions ³
³ ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

F = FILE_ID.DIZ description format is a 10 line description of
a file each line no more than 45 chars. HSLTAG's internal
editor will automaticly format the desciption to this
standard. Once fished editing your newly created DIZ file
will be put into the ZIP file by shelling out to a batch
file called ID.BAT. A working copy of ID.BAT is included
with HSLTAG. The batch file must be found either in your
path or in the directory HSLTAG is run from.



If the file already contains a FILE_ID.DIZ file you will be
prompted accordingly and asked if you want to view the de-
scription.


HSLTAG 1.0 User Documentation - 5 -



S = DESC.SDI description format is a single line description of
a file 60 chars long. HSLTAG will offer you a single line
editor to enter your description if no internal DESC.SDI is
found in the file.

If the tagged file contains a DESC.SDI file you will be
prompted accordingly and asked if you want to view the des-
cription.

O = Creates the DOZ description file format. An external file,
the DOZ file is uploaded along with your tagged files. This
format only works with RBBS-PC systems running RBATCH by Dan
Shore.


Each file is marked with these three chars {FI. The file name
follows and then the category that you would enter it in ( as
per the BBS directory of directories you are calling. On my
system, category 1 is the communications files directory. An
entry in a DOZ file for a file uploaded to this directory
would look like this:


{FI COMMPROG.ZIP 1
This is a communications program from Portugal. Powerful
script language and external protocal management. A must
for the power BBS user!

Once the RBBS-PC system using RBATCH to process batch uploads
sees the DOZ file it will automaticly post the description in
category 1 of its file listings. This frees the caller from
entering any keystrokes to describe and categorize files
while on line. HSLTAG writes this file in the correct
format. You of course are responsible for entering the cor-
rect categories and descriptions before you execute your BBS
calling and upload session.


OnLine HotKeys:

These commands are found in the upper right hand quadrant of the
HSLTAG menu:

É Online Hot/Key »
º º
º ESC = Exit º
º º
º F2 = Shell º
º º
º F4 = HS/Link º
º º
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ

HSLTAG 1.0 User Documentation - 6 -



When you shell from your COMM program to HSLTAG while on-line, these
are the three primary commands you want available to you since you
have already done your tagging and editing while off-line.


ESC = Everone needs to exit at one time or another.

F2 = Sometimes you need to get to DOS. We figured there was
no reason once in HSLTAG to exit to your COMM program to
shell to DOS so we put this one in here.

F4 = Starts your HS/Link communications session. If you have
told the remote system to send you files and you have
tagged files to send them this will begin your bidirection-
al transfer.

If you have not tagged any files but have told the remote
system to send you files this command will begin the
HS/Link single direction transfer.

If you have tagged files and told the remote system you are
sending a file using HS/Link this command will begin your
transfer if you have files tagged.

Configuration:

The bottom right hand quadrant of your HSLTAG menu allows for you to
configure HSLINK and HSLTAG. You must have HSCONFIG.EXE in your path
or current directory. Configure HS/Link according to HS/Link documen-
tation. HSLTAG will not run if it cannot find this file as HS/Link
configuration is manditory for HSLTAG to do the job for you.

C = HS/Link Configuration. See HS/Link documentation.

H = HSLTAG configuration.

HSLTAG has 4 configuration options:

A. The full path and filename of your text editor. This is only
necessary if you wish to edit your DOZ file description and/or
file lists.

B. The default path location where you store files to send.
Please note there is no trailing backslash!


C. Whether or not you are using a fossil driver. If your answer
is yes, HSLTAG will require FHSLINK.EXE to be in the current
directory or in your path. FHSLINK.EXE is distributed with
HSLINK. If you are not using a fossil driver HSLTAG will re-
HSLINK.EXE to be in the current directory or in your path.


HSLTAG 1.0 User Documentation - 7 -


D. Tagger options.

1. When displaying files to tag them the tagger will not
prompt you for which sudirectory files to display. Rather,
it will go directly to the default subdirectory named in
you configuration and display all files [*.*].

2. The tagger will go to the default subdirectory named in
you configuration and prompt you for file specifications.

3. The file tagger will prompt you for a subdirectory to
display and for file specifications.


Calling HSLTAG from your COMM program.


Currently HSLTAG is known to work with Telix 3.20, Boyan 5.0, Procomm
for Dos, Procomm for Windows, QModem and {COMMO}. Setting up HSLTAG
to run from your communications program is simply a matter of setting
up a macro key to call HSLTAG.



Telix:

A SLT file has been provided for Telix users. This file must be
compiled using the Telix Script compiler.



Boyan:

Load Boyan. Enter Alt-C. Enter M. Enter H. Enter 79. Type:
\DC[HSLTAG.EXE] Hit Return to Save. Hit ESC to Exit Macro
configuration and ESC to return to your terminal. Another
effective way to set up the macro would be to add HSLTAG to
the external protocol options. To do this Enter CTRL-C. Press
X for external protocols. Select one of the open lines and
press the appropriate number for that line. In the first field
enter HSLTAG. Enter H in the second field. Enter HSLTAG.EXE
in the third field. Enter YES in the fourth field and in the
fifth field Enter "HS*" ^B "R". This will automaticly call
HSLTAG when Boyan detects the remote system is ready to send
files. Simply press F4 when the HSLTAG menu appears.

Procomm Plus for DOS:

Hit ALT S. Go to External Protocols. Under A type "HSLINK"
Under C Upload command: Enter HSLTAG.EXE. Under D Download
Command: Enter HSLTAG.EXE. If using TAGFILE.EXE "External
Protocol #2. E should say TAGFILE. Both G and H say
TAGFILE.EXE.

HSLTAG 1.0 User Documentation - 8 -


Procomm Plus for Windows:

Enter ALT-S. Double Click MetaKey and select one of the unused Bars
numbered 1 - 9 and 0. You will see three boxes the first labeled
"TYPE". Click on the first option in this box and select program.exe.
In the next field "CONTENTS" enter "HSLTAG.EXE" without the quotes
of course. Click the third field "LABEL" and enter "HSLTAG" - again
without the quotes. Click the Save button. You will be returned
to the setup box. Drop it's upper left corner and click save
and exit. HSLTAG will appear on one of the meta bars at the bottom
of the screen. Make sure all HSLTAG files and utilities are in your
PROWIN directory or your path and that HSLINK.EXE, FHSLINK.EXE and
HSCONFIG.EXE are located in the same way, in your path or in your
PROWIN subdirectory.


Now, a little about Windows. ...perhaps it is my inexperience with
Windows but in my opinion it is brain damaged when it comes to commun-
ications. If you run into high speed transfer problems here is a sol-
ution which has worked with our beta testers. Get hold of a fossil
driver such as Ray Gwinn's X00.SYS ( Available at Church Chatters BBS
as X00V124.ZIP). Load the driver in your CONFIG.SYS The following
line works on com1. Device=x00.sys E 1 B,0,38400. If you are using a
buffured 16550 UART (NS16550AFN) in your COMM port add a space after
your speed and then F=15. The line would look as follows:

Device= x00.sys E 1 B,0,38400 F=15 (B,0,38400 = Baud on COM1 = 38400)

(B,1,38400 = Baud on COM2 = 38400) Read Ray Gwinns documentation if
you want more information. Make sure your PROWIN is set at the same
speed, your dialing directory is set to the same speed and that
HS/Link is set to the same speed. If you do high speed transfers and
run into problems it may be that you have a brain damaged UART. Using
X00's utility XU.EXE type "XU S" at the dos promt and it will tell you
what kind of chip you have. If you have anything other than a 16550
then you WILL run into problems with bi-directional high speed trans-
fers. This seems to fake out Windows and HS/Link will run like a
charm with these settings and the correct COM chip when using HSLTAG
in PROWIN.

External Utilities:

ID.BAT = A batch file which comes with your HSLTAG package. It is
called by HSLTAG when compressing your newly created DIZ
and SDI files into the files they describe. HSLTAG pas-
ses three parameters to this batch file. The first is
the file name which the description file will be added
to. The second is the name of the file to be added to
the compressed file (File_id.diz or Desc.sdi ). The
third parameter is the compression format. We left this
as an external function so you may edit the batch file
to do anything else you wish it to such as adding BBS
ads or LOGO files.

HSLTAG 1.0 User Documentation - 9 -


Compression formats supported by HSLTAG are ARJ,ZIP, ZOO, LZH, PAK
and ARC. The programs needed for these formats are ARJ.EXE,
PKZIP.EXE, PKUNZIP.EXE, ZOO.EXE, LHARC.EXE & PAK.EXE. These util-
ites can be found on most BBS systems. They must be placed in your
path or in the directory from which HSLTAG is run.

External Editor. I have been tempted to write my own editor for
HSLTAG but have decided against it so as not to reinvent the wheel.
The New DOZ format for RBBS can be editor intensive if you have
a large number of files to describe. Plus, I always like to have
access to my favorite editor so why not in HSLTAG. We use QEdit
at Church Chatters and always have the most current version on
line - Semware mails us their latest releases for the board. The
last version we have received from them is QEDIT215.ZIP.

HSLTAG comes with two executable files. HSLTAG.EXE and HSDIRN.EXE.
HSDIRN.EXE is the tagger. HSLTAG shells to this utility. This is
primarily because of the desire to not make HSLTAG.EXE too large
HSLTAG.EXE must be found by HSLTAG in either your path or in the
subdirectory from which you run HSLTAG.


































HSLTAG 1.0 User Documentation - 10 -

License and Registration
_________________________________________________________________

This program is not free! You are hereby licensed to use this program
for a trial period of 30 days free of charge. If, after 30 days, you
decide that you would like to continue using HSLTAG, you must complete
the registration form (REGISTER.DOC) and return it to the author with
the required registration fee enclosed.

Registration removes the "UNREGISTERED" messages as time delays.

Basic HSLTAG registration costs $15 US, which includes a proof of pur-
chase. For $25 US, a disk containing the latest release of HSLTAG,
along with a receipt can be obtained. Each registration is valid for
use on a single CPU. Registration #'s will be assigned once we are out
of the Beta phase of release 1.00.

Please feel free to distribute unregistered HSLTAG to your friends and
local BBSes as long as all of the files in this archive are included
and unmodified.

Send your registration payment to: THOMAS P. HANSEN
702 SHANNON.RD
PAPILLION, NEBRASKA 68046
U.S.A.

Your HSLTAG registered version may be picked up ON LINE if you care
not to wait for the mail and will be posted for you in the personals
section of our BBS off the main file menu. Credit card orders are
unavailable at this time. Our BBS line is open 24hrs per day. Call:

Church Chatters(tm) BBS
402-593-8863 14.4k v.32bis

We may be reached through the RelayNET as Node ->OUTRIDER or (#693)
FidoNET 1:285/[email protected]
InterNet @chat.omahug.org

LICENSE AGREEMENT FOR SHAREWARE DISTRIBUTORS

Shareware distributors may distribute this program as long as the author
has been notified, in writing, prior to ANY distribution. The "per disk"
charge may not exceed $6 and the shareware distributor will not change
the above license fee for the end user of HSLTAG. End users are not
exempt from registering HSLTAG with the author at the normal registration
fee.
DISCLAIMER

IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES,
INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER
INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF
YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY
CLAIM BY ANY OTHER PARTY.


HSLTAG 1.0 User Documentation - 11 -