Gpc October 2000

gpc@gnu.de

29 participants
35 discussions

Re: GPC - Manual
by Jose' M. Perez 05 Oct '00

05 Oct '00

The format looks good, but I would suggest several changes. First, if "Reference-Card" is the version number, put the version number in the page footer. Second, replace "Theme" with "Subject" or "Command", "Function", or something more suitable. The syntax section uses a notation that I am not familiar with. You might need an explanation of how to interpret the syntax. Good luck and thank you for volunteering! -----Original Message----- From: U. Bauermann <uwe(a)bauermann.de> To: gpc(a)gnu.de <gpc(a)gnu.de> Date: Sunday, September 17, 2000 12:12 PM Subject: GPC - Manual >Hi. > >The GPC-manual is most uncomplete. >Especialy the refence. >I will help to make the reference complete. >I must teach my students 'how to programming in Pascal'. >And i almost make my own scripts. >I can make my docs like a format, that they fit in the GPC-manual. >Today, i am learning LaTeX, and the GPC-manual must be in TeXInfo. >Is this right? >Is there a tool to convert LaTeX to TeXInfo? >(Sorry, i don't know anything about TeXInfo. But when it >is necessary i will learn it.) >In my docs (my scipts) i have a basicly layout. >When it is possilbe to use this layout for the GPC-reference >i'm verry happy, and i will help to make it complete. >('Uff' was this really my words?) >There is a haeder and a footer. >I have made an example in LaTeX. You can take a look: >http://www.bauermann.de/GPC/manual/reference/ >(Several formats: LaTeX, dvi, ps and/or jpg) >This basicly form looks good in my eyes. >Please, think about it and tell me your ideas. >It's only an example. >Then we can change it to make it perfect. >Sorry my english-grammar. I use my english only for reading, now. > >Greetings > Uwe > >PS.:BTW: Sorry my LaTeX-Code. I'm a beginner. Please send me > suggestions, corrections, optimum, ... Thanx > >-- >Zu Fragen, Risiken und Nebenwirkungen wenden Sie sich bitte an: >Email: uwe(a)bauermann.de >Homepage: http://www.bauermann.de >

2 1

Re: Styles
by Eike Lange 05 Oct '00

05 Oct '00

Hi! On Mon, Oct 02, 2000 at 03:36:35PM +0200, Frank Heckenbach wrote: > Eike Lange wrote: > > While discussing about different Pascal-styles for > > the pindent-program there came up a question my books > > can't answer: > > array [1..3] <===> array (.1..3.) > > { comment } <===> (* Comment *) > The standard calls the latter "lexical alternatives". > BTW, another alternative is `@' for `^' (really!)... :-/ Ok, we are going to support this, too ;-) > With the comment delimiters, there seem to be different opinions. > I personally prefer `{ }' (analogous to `[ ]'), but Peter prefers > `(* *)' so that comments are more visible. We are going to support a switch to support both variants. Later, we will ask you for a set of suggestions for our switch --gpc-team or something like that. :-) > Oh yeah, another thing to complicate the issue: To indicate > "FIXME"s, we're currently using two or more (depending on the > urgency) `@'s in a comment -- then, of course, always `(* *)' > comments because they obviously require special attention. So, e.g.: > (*@@ This procedure is a temporary kludge. It will disappear when > foobar has been done correctly. *) > procedure foobar_kludge; > This comment should, of course, not be converted to `{@@ }', even if > it's before a declaration, but for a program it's also not hard to > recognize the `@'... Well, some tools for C/C++/Java support "Doc-Comments" (KDoc, Doc++, JavaDoc, ...) They are bild like this /** This is a Doc-Comment */ and the char '@' indicates a command like /** This is a command for KDoc @author someone, someone(a)somewhere.in.universe */ We would like to write a pdoc after pindent and also want to support some "@"-commands like: (** This might be a pdoc-comment some time @author me, me(a)somewhere.in.universe *) Do these commands conflict with you comments for "FIXME"s ? Eike

2 1

Re: Styles
by Olivier Lecarme 04 Oct '00

04 Oct '00

>>>>> "EL" == Eike Lange <eike.lange(a)uni-essen.de> writes: EL> Hi! EL> While discussing about different Pascal-styles for EL> the pindent-program there came up a question my books EL> can't answer: EL> How are the different styles called, EL> which one can use for coding: EL> array [1..3] <===> array (.1..3.) EL> and EL> { comment } <===> (* Comment *) EL> BTW: EL> Why did these styles came up? EL> Is one of them "old-fashioned"? Pascal was first implemented on a CDC 6600 computer. Characters were coded on 6 bits, and thus there were only 64 different characters, including end-of-line. There were no square brackets, no circumflex, but there were curly brackets, an up arrow and a Â« not equal Â» operator. Thus, {} is as old as the first implementation, but [] is less old. ^ for pointers and <> for comparison are newer than the old characters, which no longer exist on most existing character codes. Olivier Lecarme

1 0

GPC - Manual
by U. Bauermann 03 Oct '00

03 Oct '00

Hi. The GPC-manual is most uncomplete. Especialy the refence. I will help to make the reference complete. I must teach my students 'how to programming in Pascal'. And i almost make my own scripts. I can make my docs like a format, that they fit in the GPC-manual. Today, i am learning LaTeX, and the GPC-manual must be in TeXInfo. Is this right? Is there a tool to convert LaTeX to TeXInfo? (Sorry, i don't know anything about TeXInfo. But when it is necessary i will learn it.) In my docs (my scipts) i have a basicly layout. When it is possilbe to use this layout for the GPC-reference i'm verry happy, and i will help to make it complete. ('Uff' was this really my words?) There is a haeder and a footer. I have made an example in LaTeX. You can take a look: http://www.bauermann.de/GPC/manual/reference/ (Several formats: LaTeX, dvi, ps and/or jpg) This basicly form looks good in my eyes. Please, think about it and tell me your ideas. It's only an example. Then we can change it to make it perfect. Sorry my english-grammar. I use my english only for reading, now. Greetings Uwe PS.:BTW: Sorry my LaTeX-Code. I'm a beginner. Please send me suggestions, corrections, optimum, ... Thanx -- Zu Fragen, Risiken und Nebenwirkungen wenden Sie sich bitte an: Email: uwe(a)bauermann.de Homepage: http://www.bauermann.de

2 1

Styles
by Eike Lange 02 Oct '00

02 Oct '00

Hi! While discussing about different Pascal-styles for the pindent-program there came up a question my books can't answer: How are the different styles called, which one can use for coding: array [1..3] <===> array (.1..3.) and { comment } <===> (* Comment *) BTW: Why did these styles came up? Is one of them "old-fashioned"? Eike Lange

2 1

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

2001

2000

1999

1998

1997

1996

1995

Gpc October 2000