From: Jurgen Vinju
To:
Date: Fri, 5 Nov 2004 13:09:56 +0100
Subject: PEM: Tobias Kuipers | Building Documentation Generators | 30.08.99

 
From: pem (PEM moderator)
To: pem-noreply
Subject: PEM meeting | 30.08.99 | M2.80, CWI 
Precedence: bulk
X-url: http://www.cwi.nl/~pem
Mime-Version: 1.0
Content-Type: text/plain;
        charset="iso-8859-1"

   Dear Environmentalists,

   This  is just a quick reminder that at 14:00 this afternoon there will
   be a PEM talk in room M2.80 at CWI.

   This announcement can be found at <http://www.cwi.nl/~pem>

                     Building Documentation Generators

   Date:    30.08.99
   Time:    14:00
   Venue:   M2.80, CWI
   Speaker: Tobias Kuipers
   Title:   Building Documentation Generators

   [joint work with Arie van Deursen]

   In   order   to   maintain   the   consistency   between  sources  and
   documentation,  while  at the same time providing documentation at the
   design  level,  it is necessary to generate documentation from sources
   in   such   a   way  that  it  can  be  integrated  with  hand-written
   documentation.  In order to simplify the construction of documentation
   generators,  we  introduce  island  grammars,  which only define those
   syntactic structures needed for (re)documentation purposes. We explain
   how they can be used to obtain various forms of documentation, such as
   data  dependency  diagrams  for  mainframe  batch  jobs.  Moreover, we
   discuss  how  the  derived  information  can  be  made available via a
   hypertext  structure.  We  conclude  with  an industrial case study in
   which  a  600,000  LOC  COBOL  legacy system is redocumented using the
   techniques presented in the paper.
     _________________________________________________________________

   The  programming environment meetings are a forum for the presentation
   and  discussion  of  new  ideas,  ongoing and finished work. A typical
   meeting  addresses  a subject in the area of programming environments,
   program  generation, algebraic specification, term rewriting, parsing,
   etc.  A presentation ideally takes between 45 and 90 minutes. Meetings
   taking  longer  than 45 minutes are interrupted by a coffeebreak. Most
   Thursdays,  a  meeting is held which starts at 10:00 am. in one of the
   rooms at CWI/WINS. Exceptionally, dates or times may change.

   The    program    of    the    meetings    is    available   on   WWW:
   http://www.cwi.nl/~pem
     _________________________________________________________________