THE WELCH COMPANY
440 Davis Court #1602
San Francisco, CA 94111-2496
415 781 5700
rodwelch@pacbell.net


S U M M A R Y


DIARY: October 7, 2004 12:56 PM Thursday; Rod Welch

Documents with outline structure improve automatic format in SDS.

1...Summary/Objective
2...Knowledge Space Fast and Easy to Construct Managing Documents
3...Command Control and of Work Navigating through knowledge Space
4...File Access Menu Modify to Specify Document to Format for Analysis
5...00702 Macro 58 Modify to Support Formatting Received Docs in SDS
6...Position Document to Analyse in SDS Record Automatically
7...Anchors Removed from Text in Documents for Analysis in SDS


..............
Click here to comment!

CONTACTS 

SUBJECTS
Received Documents Shift Text Lines to Desired Left Margin
Menu F1 F3 Specify Documents Format Email in SDS Records Using Get Co
SDS Analyse Documents F1 F3 Macro 58 to Provide Template for User to

1205 -
1205 -    ..
1206 - Summary/Objective
1207 -
120701 - Follow up ref SDS 7 0000, ref SDS 5 0000.
120702 -
120703 - Improved feature that formats documents for analysis in SDS records,
120704 - which mostly effects email.  Increased the range of format variances
120705 - that occur, so that analysis takes less time to get set up.  Tried to
120706 - add automatic justify of text, but could not figure out how to tell
120707 - the code when to justify and when not to justify, so leave it to the
120708 - user.  Main advantage is to automatically configure some outline
120709 - formats into the SDS structure, including set up anchors correctly, so
120710 - the user does not have to spend a lot of time changing a lot of
120711 - structure.
120712 -
120713 -       [On 041015 received a letter from Gary with a wide variety of
120714 -       formats that enabled improving the SDS document analysis
120715 -       function. ref SDS 8 TM3O
120716 -
120717 -
120719 -  ..
1208 -
1209 -
1210 - Evaluation
1211 -
121101 - Knowledge Space Fast and Easy to Construct Managing Documents
121102 - Command Control and of Work Navigating through knowledge Space
121103 -
121104 - Follow up ref SDS 7 6O8S, ref SDS 5 PI7K.
121105 -
121106 - Improvements today require users to...
121107 -
121108 -    1.  Manually double space outline structures that are wrapped to
121109 -        column 1 in the original source document file. ref SDS 0 9U6O
121110 -        Use Alt F10 to this separation in the file x.txt.
121112 -         ..
121113 -    2.  Manually shift nested outlines that are wrapped to column 1 in
121114 -        the original source document file.  This is typically only a
121115 -        few keystrokes for each nested outline group using F1 F1 F7
121116 -        after file x.txt is read into an SDS record.
121117 -
121118 -            [On 041015 Gary's letter illustrates this use case.
121119 -            ref SDS 8 OL6R
121120 -
121122 -  ..
121123 - This is a fairly significant improvement for saving time and money by
121124 - reducing the amount of custom work to conform document formats into
121125 - structures that fit SDS formats.  Improvements on 030823 consolidated
121126 - commands that reduced work formattig the most common documents that
121127 - occur in email. ref SDS 5 0001  However, text occurs in documents with
121128 - a very wide range of different formats which require adjustments for
121129 - common treatment to manage context efficiently.  The work today
121130 - extends automatic treatment to the following issues...
121131 -
121132 -        1.  URL addresses automatically indented, and will not be
121133 -            assigned outline structure, since most of the time, URL
121134 -            addresses wind up being deleted from the SDS record.
121135 -            ref SDS 0 VG5O
121137 -             ..
121138 -        2.  Outline structure is indented and the prior problem of
121139 -            doubling the outline structure is eliminated, which
121140 -            previously has taken a lot of time to fix.
121142 -             ..
121143 -            People use a variety of outline formats, so the challenge
121144 -            is to develop code that automatically recognizes variety
121145 -            and conforms to SDS standards.
121147 -             ..
121148 -            Outlines that are indented which is the most common
121149 -            format, can be readily recognized.
121151 -             ..
121152 -            Outlines in email often don't indent the order element, and
121153 -            so a means is needed to recognize when an outline structure
121154 -            occurs and to indent everything to an approrpiate left
121155 -            margin for the ordering element and for subsidiary lines,
121156 -            two (2) columns beyond the ordering element.
121158 -             ..
121159 -            For some reason, people seem to construct outlines in email
121160 -            with text on the first line indented 5+ spaces beyond the
121161 -            ordering element, perhaps using the tab key, rather than
121162 -            the standard 1 or 2 spaces, thus often this is
121163 -            encountered...
121164 -
121165 -                     e.        This is an example of typical outline
121166 -                     structure found in email.  Why someone would do
121167 -                     this is not clear.
121168 -                     f.        This example of ordered outlining in an
121169 -                     email requires the user to manually add a space
121170 -                     to separate the listed items, as shown in the
121171 -                     next example.
121173 -                      ..
121174 -                     g.        This example of ordered outlining is
121175 -                     handled by SDS by shifting the structure to the
121176 -                     correct column, and shifting the text to the
121177 -                     correct left margin., including multiple lines.
121179 -             ..
121180 -            Bullets are created with a variety of symbols.  Some
121181 -            people use the asterisk character 42.
121182 -
121183 -                     *         Example of common outlining using
121184 -                     bullets that places an asterick on column one and
121185 -                     indents text on that line 5+ spaces, then wraps
121186 -                     multiple lines to column 1.
121187 -                     *         Another example of stacking outling
121188 -                     with bullets in a single space mode; SDS does not
121189 -                     handle this well.  User has to manually separate
121190 -                     different parts of the outline.
121191 -
121192 -                     *         This example, SDS handles okay by
121193 -                     chaning the * to an SDS bullet, and setting up
121194 -                     the spacing and left margin correctly.
121196 -             ..
121197 -        3.  Anchors in original text are removed when documents are
121198 -            entered into SDS records for analysis.  This eliminates
121199 -            problems of incorret formatting where outline structure is
121200 -            added to the anchor line, and where anchors are embedded
121201 -            into text, which is not an SDS standard, but is common to
121202 -            documents.
121204 -  ..
121205 - These improvements do not address all formatting problems.  Experience
121206 - shows they are among the most common situations.  Ability to conform
121207 - non-standard formats to standard outline formats automatically, i.e.,
121208 - without investing additional time, should increase use of Knowledge
121209 - Space for command and control of the work based on situational
121210 - awareness.  Better command and control of the work increases
121211 - productivity and earnings by saving lives, time, and money.
121212 -
121213 -
121214 -
121216 -  ..
1213 -
1214 -
1215 - Planning
1216 -
121601 - File Access Menu Modify to Specify Document to Format for Analysis
121602 -
121603 - Follow up ref SDS 7 VC6L.
121604 -
121605 - On 030823 developed macro 00702 to expedite entering documents into
121606 - SDS records using the Medit get command and applying standard SDS line
121607 - number format for Knowledge Space. ref SDS 5 5L6J
121609 -  ..
121610 - Experience shows this is very handy, and that it might be possible to
121611 - reduce time and effort to handle complex documents with outline
121612 - structure by expanding the scope of automatic formatting, so there is
121613 - less "clean up" for people to do analysing documents.
121614 -
121616 -  ..
1217 -
1218 -
1219 - Progress
1220 -
122001 - 00702  Macro 58 Modify to Support Formatting Received Docs in SDS
122002 -
122003 - Follow up ref SDS 7 VC9F, ref SDS 5 5L6J.
122004 -
122005 - Line 30, ref OF 1 414J, in 00702
122006 -
122007 -    -goto start
122008 -    -goto execute
122009 -    -goto esc
122010 -
122011 -
122012 -
122014 -  ..
122015 - Position Document to Analyse in SDS Record Automatically
122016 -
122017 - Follow up ref SDS 7 DJ4L.
122018 -
122019 - Line 430, ref OF 1 OF5N, -label lpdwN in 00702 about 50 lines below.
122020 -
122021 -    Test bebug here.
122023 -  ..
122024 - Line 510, ref OF 1 T37O, -label lpln2
122025 -
122026 -    -if @9 > 32 -if @174 = 3 -if @10 > 0 -if @1 = 1 ins_text!000001 -    2.!
122027 -
122028 -        Added conditional @9 > 32 that avoids adding outline structure
122029 -        to text elements that do not need outlining, and set in the
122030 -        subroutine. ref SDS 0 YQ4I
122031 -
122032 -
122034 -  ..
122035 - Anchors Removed from Text in Documents for Analysis in SDS
122036 -
122037 - Line 520, ref OF 1 UW3M, -label 17s in 00702
122038 -
122039 -    -label 17s
122040 -    z 1 70
122041 -    loc_cur 0 80
122042 -    errorcnt 0 0
122043 -    fl /</
122044 -    -if @0 > 0 -goto natl
122045 -    setcur 13 0
122046 -    addcnt 13 6
122047 -    -if @10 > @13 -goto delA
122048 -    immed d
122049 -    subcnt 36 1
122050 -    -goto natl
122051 -    -label delA
122052 -    macro 79
122053 -    -label natl
122054 -
122055 -        Find anchor symbol, and if it is on a line by itself, delete
122056 -        the line, and if not then use macro 79 to delete just the
122057 -        anchor string.  This seems like the simplest, most direct way
122058 -        to support SDS anchor formatting, which SDS constructs with
122059 -        the F2 save function.
122060 -
122061 -
122062 -
122064 -  ..
122065 - Line 560, ref OF 1 YU3K, -label natl in 00702
122066 -
122067 -    -label natl
122068 -    pushc
122069 -    z 1 8
122070 -    errorcnt 0 0
122071 -    fr !://!
122072 -    popc
122073 -    chrcnt 9 0
122074 -    -if @0 = 0 setcnt 9  32
122075 -    -if @9 = 46 setcnt 9 32
122076 -
122077 -        Added code to test -if @0 = 0 setcnt 9 32 for URL so it can be
122078 -        indented, and so that outline numbers are not added, that then
122079 -        have to be removed. chrcnt 9 0 evaluates when a line is
122080 -        indented, and sets a flag to avoid adding outline structure.
122081 -        The basic theory that indented lines already have outline, and
122082 -        so there is no need to add outline structure, because this is a
122083 -        duplication that the user has to remove, which takes more time.
122084 -
122085 -
122086 -
122087 -
122088 -
1221 -