[Search for users] [Overall Top Noters] [List of all Conferences] [Download this site]

Conference vaxuum::document_ft

Title:DOCUMENT T1.0
Notice:**New notesfile (DOCUMENT.NOTE) now available (see note 897)**
Moderator:CLOSET::ADLER
Created:Mon Feb 09 1987
Last Modified:Thu Oct 31 1991
Last Successful Update:Fri Jun 06 1997
Number of topics:897
Total number of notes:4397

365.0. "<box> alignment question" by AUTHOR::GREENMAN () Tue May 12 1987 13:58

    We have a number of memory maps in our documentation. If we could
    use DOCUMENT to do the boxes, tht would save doc prep from having
    to do artwork.
    
    I've tried using the <box> tag with <line> and <align_char> tags
    and it works pretty well; but, the right part of the boxes do not
    line up exactly. This is especially apparent when you have a box
    with numbers above or below a box with characters. The left side
    of the boxes is lined up fine.
    
    What I'm trying to do is like the following:
    
    Request Format:
    		      +----------------+
    	R0 -->area:   |  13    |  chan |
    		      +----------------+
    		      |      ochan     |
    		      +----------------+
    		      |     jobblk     |
    		      +----------------+
    
    It works pretty well - the small space between the boxes is ok -
    but the ragged right line is a problem. Is there anything, using
    straight DOCUMENT (we don't have GRED or anything like that here)
    that I can do to ge the right part of the boxes to line up?
    
    Charlie Greenman (RT-11 documentation)
T.RTitleUserPersonal
Name
DateLines
365.1It's unsupported, but PICMODE is an optionCOOKIE::JOHNSTONTue May 12 1987 20:5212
I hate to even mention it since it is an unsupported tool, but you could 
try PICMODE.  If you do a dir/keyword=figures you should be able to get 
a list of notes that refer to it; there are a few tricks.
You'll have to generate the picture in an external file and 
<include_tex_file> the picture in. On the other hand, you won't have to 
mess with align characters and such.

This response assumes that you didn't know about PICMODE, of course.



Rose
365.2Funny how minds coincideCHAMBR::GUINEAUWed May 13 1987 09:1740


 Strange this note should appear now.

 I was just writing up a "requestion" (Request/question)



How about a SOFTWARE tag to generate data structures?

Ex:

 <DATA_STRUCTURE>(PCB\32)		! name PCB, 32 bits wide
 <DATA_ELEMENT>(32\PID)			! first longward is PID
 <DATA_ELEMENT>(16\CHAN_CNT)		! next word is 16 bit, channel count
 <DATA_ELEMENT>(16\REF_CNT)		! another 16 bit element
 <DATA_ELEMENT>(32*3\PROC_NAME)		! 12 character name
 <ENDDATA_STRUCTURE>


 would generate:

        31         15         0
  	+---------------------+
	|         PID         |
	+---------------------+
 	| CHAN_CNT | REF_CNT  |
	+---------------------+
	|                     |
	+                     +
	|     PROC_NAME       | 
	+                     +
	|                     |
	+---------------------+


  Only in a "nice" box


365.3only needs documentation...CLOSET::ANKLAMWed May 13 1987 12:3513
    
    Actually, we do have such a tool, and TeX macros that do all of
    that. It's not part of the external, customer kit, but its use
    requires a fair amount of twiddling. What we do is create SDML files
    from SDL files for data structures. The base tool hasn't yet been
    updated for T1.0 names (it also creates definition list tags for
    a definition list to go with the structure names).
    
    Once we get V1 out, I should have time to take a look at the data
    structure things and explain how to use them.
    
    patti
    
365.4And I even used SDL!CHAMBR::GUINEAUWed May 13 1987 18:214


 All Right!
365.5in a past incarnationCLOSET::ANKLAMThu May 14 1987 17:492
    
    ...and I even wrote the original SDL User's Guide...
365.6by the way, should I wait?CHAMBR::GUINEAUFri May 15 1987 11:5820
< Note 365.3 by CLOSET::ANKLAM >
                        -< only needs documentation... >-

    
    Actually, we do have such a tool, and TeX macros that do all of
    that. It's not part of the external, customer kit, but its use
    requires a fair amount of twiddling. What we do is create SDML files
    from SDL files for data structures. The base tool hasn't yet been
    updated for T1.0 names (it also creates definition list tags for
    a definition list to go with the structure names).
    
    Once we get V1 out, I should have time to take a look at the data
    structure things and explain how to use them.
    
    patti



 How long ?    

365.7SDL experts?CLOSET::ANKLAMMon May 18 1987 12:4912
    
    Any SDL experts out there? It turns out that the SDL->SDML translator
    is broken as of Version 3 of SDL (it no longer handles unions
    correctly). We don't have the resources to correct the problems
    at present. 
    
    The sources for the SDL-SDML translator are written in PL/I. I'd
    be happy to share them with anyone who might have the time/inclination
    to fuss with it. 
    
    patti anklam