Conference vaxuum::document_ft

1) Slide tags should have placeholders where user can enter text
   instead of the current definition as in:
	<AUTHOR_INFO>(\\\)
   should be
	<AUTHOR_INFO>({text}\[text]\[text]\[text])
   or something similar.  Preferably with tags that accept a limited number
   of multiple like arguments, the placeholder definitions should allow you
   to only enter as many arguments as the tag allows.  Obviously you can't
   prevent the user from adding arguments, but the substitution that goes on
   should lead the user to enter no more that the maximum number of arguments
   with the proper seperation.

2) The memo placeholders use a general {line}... placeholder in their
   definitions.  If the user blindly types over those tags to get multiple
   lines, they don't get any argument seperators.

3) Will there be language specific help available?

4) What will be the final resolution of the COMPILE/REVIEW with respect
   to specifying the design and destination?

-tl

PS  Keep up the good work!  With a suitable LSEDIT environment for SDML,
    DOCUMENT will gain much more interest by the casual documenters in my
    group.

    If you're running BL8 today (having obtained a version prior to
    the announcement), there is one known problem:  the LSE environment
    does not get upgraded.  When the new baselevel is announced you
    will be able to do a partial update of DOCUMENT to install only
    the LSE environment.  Anyone installing the announced version 
    will not have to worry about this problem.
    
    The two problems that you mentioned have been corrected in the
    upgrade.  Some modifications have been made to the environment
    as a whole, which are documented in the release notes.
    
    Julie

See note 234.6 for an interim work around for that early BL08 problem.


-tl

    I hit a trivial bug in LSE today.  I entered the "emphasis" tag
    and expanded it.  LSE gave me "\ITALICS" as an option.  When selected
    and processed DOCUMENT gave me an error that the argument was invalid.
    Turns out (I think) that DOCUMENT wants "\ITALIC" without the "S".
    This works.  As italics is the default it isn't going to get hit
    much I don't think, but it was a bit wierd.
    
    The profile tags in LSE ask (require) a book name.  When I give
    it one DOCUMENT yells that the profile is invalid.  
        
    I also changed a couple tags from the letters and memo's.  (I did
    this a while ago so my memory is weak).  As I recall, the changes
    are to get rid of the <NAME> tag (which my DOCUMENT yelled about
    every time), and to get address lines separated by a "\".  I did
    this in both business-letters and memo.  
            
DELETE PLACEHOLDER "BUSINESS-LETTERS" -
    /LANGUAGE=SDML
DEFINE PLACEHOLDER "BUSINESS-LETTERS" -
    /LANGUAGE=SDML -
    /NOAUTO_SUBSTITUTE -
    /DESCRIPTION="Tags for letters" -
    /DUPLICATION=VERTICAL -
    /SEPARATOR="" -
    /TOPIC="[help-topic]" -
    /TYPE=NONTERMINAL -
    /LEADING="" -
    /TRAILING=""

    "<FROM_ADDRESS>({lines}...)"
    ""
    "<TO_ADDRESS>({lines}...)"
    ""
    "<SALUTATION>({text})"
    ""
    "{body}"
    ""

        "<CLOSING>({lines}...)"
    ""
    "<CCLIST>"
    "<CC>({text})"
    "<ENDCCLIST>"

END DEFINE

    DELETE PLACEHOLDER MEMOS -
    /LANGUAGE=SDML
DEFINE PLACEHOLDER MEMOS -
    /LANGUAGE=SDML -
    /NOAUTO_SUBSTITUTE -
    /DESCRIPTION="Tags for memos" -
    /DUPLICATION=VERTICAL -
    /SEPARATOR="" -
    /TOPIC="[help-topic]" -
    /TYPE=NONTERMINAL -
    /LEADING="" -
    /TRAILING=""

    "<MEMO_HEADER>"
    ""
    "<MEMO_FROM>([lines]...)"
    ""
    "<MEMO_TO>([lines]...)"
    ""
    "<MEMO_LINE>({heading}\)"
    ""
    "<MEMO_DATE>()"
    ""
    "<SUBJECT>({text})"
    ""
    "{body}"
    ""
    "<CCLIST>"
    "{cc}..."
    "<ENDCCLIST>"
    ""
    "<DISTLIST>"

END DEFINE

DELETE PLACEHOLDER LINES -
    /LANGUAGE=SDML
DEFINE PLACEHOLDER LINES -
    /LANGUAGE=SDML -
    /NOAUTO_SUBSTITUTE -
    /DESCRIPTION="Address lines" -
    /DUPLICATION=VERTICAL -
    /SEPARATOR="\" -
    /TOPIC="[help-topic]" -
    /TYPE=TERMINAL -
    /LEADING="" -
    /TRAILING=""

    "line of text for address, to/from, etc."
END DEFINE
    
Dave P

    Sounds like you're using the old LSE environment.  If you've
    installed Baselevel 8 of DOCUMENT you should also install
    the new LSE environment.  The ITALICS problem and the 
    <PROFILE> problem were both corrected in the new environment.
    
    The <NAMES> tag is gone too...I'll check on the argument
    delimiter for {lines}...
    
    
    Julie

    HM.  I'm running BL8.  At least DOCUMENT thinks I am.  Is it possible
    to install the newest version and NOT have it update LSE?  I definitely
    told it to put LSE support in.
    
    I'll install it again, and only tell it to do a partial and give
    me LSE support.  
    
    Dave P

    there were problems installing SDML support in LSE because
    of a bug in our installation procedure.  If you will tell me
    where the DOC010.A file is for the kit that you are using,
    I'll take a look and see what it is doing.
    
    bill
    

    May I suggest that Document use the /VERSION qualfier on the LSE
    DEFINE LANGUAGE command, to make it easier to track questions and
    complaints concerning the LSE templates?  The sole purpose of the
    /VERSION qualifier is to be a version number for the templates (which
    you may choose to make identical to the Document version number,
    but aren't forced to).  The only effect of the /VERSION qualifier
    is to show up in the SHOW LANGUAGE command (on the same line as
    the language name), and of course, in the EXTRACT LANGUAGE command.
    
       Gary

    I've read through quite a few notes in an attempt to find someone
    else with this problem, but to no avail!
    
    When we installed BL8 we took LSE support (having installed 2.0
    of LSE previously). Now, the release notes state that the extension
    required to invoke the SDML environment is SDML and no longer GNC.
    For us, GNC invokes the environment (with a few erroneous tags by
    the way) and SDML does not.  We get "not associated with a language"
    errors when trying to expand.
    
    Do we just need to reinstall DOC'T (partially) or what?
    
    Gavin

    See reply 7.
    
    If I can see the DOC010.A file that you are using I may be able
    to help.
    
    bill
    

    The <PREFACE> placeholder expands to <PREFACE>({number}).  However,
    the number is an optional argument, so it shouldn't be a required
    placeholder.

    Also, I find some of the messages not as descriptive as they could be.
    For example, since it's been a while since I've done a preface, I wasn't
    sure just what the 'number' argument was (I also needed to check whether
    it was in fact optional).  When I expanded the placeholder, I got the
    helpful message "Enter a number."  I had to resort to looking up the
    tag in the manual (gasp, no!), which defeats the purpose of having
    online help text. A message like "Enter the number of the page the
    Preface is to begin on" would be much better. This is true for other
    messages.  Help text that tells me to "enter a number" or to "enter
    some text" would be much MORE helpful if it gave me some context
    ("enter the page number" or "enter the text of the title" and so on). 

							-- Nina