From ST2975@SIUCVMB.SIU.EDU Thu Nov 26 01:29:20 1992 Received: from calvin.sfasu.edu by umaxc.weeg.uiowa.edu (5.61.jnf/920629) on Thu, 26 Nov 92 01:29:17 -0600 id AA09028 with SMTP Received: from SIUCVMB.SIU.EDU by calvin.sfasu.EDU with SMTP (5.59/25-eef) id AA25377; Thu, 26 Nov 92 01:21:05 CST Return-Path: Message-Id: <9211260721.AA25377@calvin.sfasu.EDU> Received: from SIUCVMB.SIU.EDU by SIUCVMB.SIU.EDU (IBM VM SMTP V2R1) with BSMTP id 5425; Thu, 26 Nov 92 01:19:48 CST Date: Thu, 26 Nov 92 01:17:18 CST From: ST2975@SIUCVMB.SIU.EDU To: hyperc-l@calvin.sfasu.edu Subject: docs table of contents Status: R Following is the table of contents for the docs. I think I left them out when I typed them up. It may be of use to those working on on-line man. Andy W. p.s. not included is the table of contents for the floating point stuff. I'll post that later. TABLE OF CONTENTS ----- -- -------- I - VI PRODOS ADDENDUM ------ -------- Table of Contents 1 Addendum Pages 2 - 28 1 Introduction 4 General 9 Getting Started (CDOS) Part 1 -- The CDOS Operating System 13 Overview of the Operating System 15 Command Lines 18 The File System 21 Memory Maps 24 Operating System Globals 27 Operating System Error Handling 29 Using Files in Programs 31 Using RWTS Part 2 -- The Language Tools 33 The Text Editor 36 Compiling with C++ 42 Differences from and Clarifications to K&R Standard C 45 C++ Extensions 51 Staying Out of Trouble -- Avoiding Undesirable Side Effects 56 Subroutine Calling Conventions 65 The Assemblers 73 The cp-Code Assembler 75 The 6502 Assembler 77 The Assembler Macro Expander 82 Linking 84 Object File Formats 87 How Overlays Work 91 A Technical Discussion of the Overlay Process Part 3 -- The Utilities Manual 93 Utility Manual and How to Read the Manual Pages 95 asmcp The cp-Code Assembler 96 asm65 The 6502 Assembler 97 c++ The C++ Compiler 98 dump The File Dump Utility 99 echo The Command Line Trainer 100 ed The Text Editor 101 fastcopy A Disk Copying Utility 102 format A Disk Formatting Utility 103 lib A Library Maintenance Utility 104 list A Text File Lister 105 lnk The Object File Linker 108 mac The Assembler Macro Expander 109 pp The C Macro Pre-Processor 110 sym The Symbol Table Lister 111 tstflags A Command Line Flag Trainer Part 4 -- The Standard Library Functions 112 The Standard Library & How to Read the Manual Pages 114 Console & Printer I/O Functions 115 _chkAbort check keyboard for user abort _prtinit initialize printer slot 116 _prtonly set printer only display mode _prtvid set printer and video display mode _vidinit initialize 80 column display mode 117 _vidonly set video only display mode beep make the console beep clreol clear to end of line clreos clear to end of screen 118 clrkbd clear keyboard pending characters conRead get a line from the console 119 conWrite write a buffer to the console cr print a newline character cursor set the screen cursor position 120 getcurs get the current scren cursor position getkey get a new key kbdRead get a line from the keyboard 121 keypress test keyboard for pending character page clear the screen or print form feed printf formatted output 123 prtWrite write a character to the printer putchr print a character putprt print a character on the printer 124 putstr print a null terminated string setcurs set cursor position vidinv set inverse video mode 125 vidnorm set normal video mode 126 File I/O Functions 127 create create a new file fprintf formatted output to a file 128 getc read a single byte from a file getl read a line from a file 129 getFPos record the current file position open open an existing file by name putc write a single byte to a file 130 puts write a null terminated string to a file read read bytes from a file remove remove an existing file 131 rename rename an existing file seek move the current file position 132 setFPos restore the current file position write write bytes to a file 133 Memory Management Functions 133 alloc allocate memory with error handling buybuf allocate room and store a string 134 free free allocated memory nalloc allocate memory or return NIL sbreak increment end of heap pointer 135 Operating System Interface Functions 135 exec load and execute a new program 136 exit exit current program load load a program into memory 137 longjmp return to a previously saved system state setjmp save current system state 138 sync synchronize disk buffers with media 139 Low Level Disk I/O 139 _dkrdwr read/write physical block 140 _findBlk search LRU buffers for a block _fpostol convert file position to long integer 141 _getBlk get the address of a block buffer (read) _getBuf get the address of a block buffer (no read) _ltofpos convert long integer to file position 142 _updateBlk mark latest block buffer as updated 143 String Functions 143 atoi convert text string to integer 144 clrbuf erase a buffer cmpbuf compare two buffers index get first instance of character in string 145 movel move bytes left mover move bytes right rindex get last instance of character in string 146 sprintf formatted output to memory buffer strcmp compare strings streq compare strings for equality 147 strlen get length of null terminated string strncmp compare strings with given length 148 strneq compare strings for equality with given length 149 Miscellaneous Functions 149 abs get absolute value of an integer error print error message and abort 150 getflags process command line flags 151 getArg obtain a blank delimeted (sic?) argument getArgs obtain blank delimeted arguments 152 isalnum test character for alpha or numeric isalpha test character for alpha isdigit test character for digit 153 ishex test character for hex digit isnil test pointer for NIL isodd test integer for odd value 154 isspace test character for whitespace ladd add long integers lsub subtract long integers max get maximum of two integers min get minimum of two integers 155 notnil test pointer for not NIL setup assembly level parameter setup routine usage print program usage message Part 5 -- Appendix 156 Description of the C-Compiler Pseudo Machine and cp-Cods 161 The 6502 Version of the C Engine 164 C-Compiler Code Generation 184 Postscript Addendum for ProDOS Users -------- --- ------ ----- Contents -------- 2 Introduction 4 Path Expressions 5 Shell Built-in Commands 5 ? show help screen bye exit to ProDOS cd change working directory cls clear screen 6 cp copy files dm dump memory ls list files mkdir make new directories mksys make files into ProDOS SYS files 7 mv move files path set/show execution path pwd print working directory ren rename file rm remove files vols show volumes online 8 Memory Use & ProDOS Considerations 9 Resident Libraries 10 ProDOS File I/O Library Functions 12 close close an open file create create and open a new file by name 13 fprintf formatted output to a file getc read a single character from a file getEOF return the position of End of File 14 getFPos return the current file position in a file getl read a line of characters from a file 15 mustCreate create and open with error checking 16 mustGetl read a line with error checking 17 mustOpen open a file with error checking 18 mustRead read bytes with error checking 19 mustWrite write bytes with error checking open open an existing file by name 20 putc write a single character to a file puts write a null terminated string to a file read read a number of bytes from a file 21 remove remove a closed file by name rename rename a closed file by name 22 seek move the current file position 23 setEOF set the End of File position setFPos restore the current file position 24 srchOpen open a file with error checking sync flush dirty file buffers 25 write write a number of bytes to a file 26 65c02 Assembler Support 26 Miscellaneous Tips and Provisos Note: there's also an index of tables and figures.(a.w.)