From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me X-Spam-Level: X-Spam-Status: No, score=-0.2 required=5.0 tests=BAYES_00,HEADER_SPAM, INVALID_DATE autolearn=no autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 100062,f1b6ff66f387e75c,start X-Google-Attributes: gid100062,public X-Google-Thread: f7ded,f1b6ff66f387e75c,start X-Google-Attributes: gidf7ded,public X-Google-Thread: 103376,f1b6ff66f387e75c,start X-Google-Attributes: gid103376,public X-Google-ArrivalTime: 1993-03-25 15:02:07 PST Xref: sparky comp.lang.ada:4815 news.answers:6883 comp.answers:326 Newsgroups: comp.lang.ada,news.answers,comp.answers Path: sparky!uunet!elroy.jpl.nasa.gov!swrinde!gatech!usenet.ins.cwru.edu!cert.org!news.sei.cmu.edu!ajpo.sei.cmu.edu!cla-faq From: cla-faq@ajpo.sei.cmu.edu (Ada Info. Clearinghouse) Subject: comp.lang.ada FAQ 2/2 Message-ID: <1993Mar25.180207.8711@sei.cmu.edu> Followup-To: poster Summary: comp.lang.ada Frequently Asked Questions. (Does *not* get into programming questions.) Sender: netnews@sei.cmu.edu (Netnews) Organization: Ada Information Clearinghouse Date: Thu, 25 Mar 1993 18:02:07 EST Date: 1993-03-25T18:02:07-05:00 List-Id: Archive-name: comp-lang-ada/cla-faq2 comp.lang.ada Frequently Asked Questions part 2 of 2 Effective date: 25 MAR 93 19) Is there a list of Ada compiler vendor e-mail contacts? (from drew@verdix.com (Drew Johnson)) Alsys sales (e-mail contact only): tne@world.std.com (Tom Erickson) Alsys sales (voice) Scott Dorman Tel: 617/270-0030 Convex questions: allison@convex.com (Brian Allison) Tel: 214/497-4346 Cray questions: det@cray.com (Dave Thersleff) Tel: 612/683-5701 Cray sales: svc@cray.com (Sylvia Crain) Tel: 505/988-2468 Harris questions: jeffh@ssd.csd.harris.com (Jeff Hollensen) IBM/Ada questions: malcho@torolab6.vnet.ibm.com (Don Malcho) Tel: 416/448-3727 Intermetrics questions: ryer@inmet.inmet.com (Mike Ryer) Irvine Compiler Corp (ICC) questions: info@irvine.com Tartan questions: englert@tartan.com (Susan Englert) Tel: 412/856 3600 Telesoft questions: adasupport@telesoft.com Tel: 619/457-2700 TeleSoft Sales: marketng@telesoft.com (Philippe Collard) Tel: 619/457-2700 Verdix questions: drew@verdix.com (Drew Johnson) Verdix sales information: moskow@verdix.com (Paul Moskowitz) Tel: 800-BUY-VADS 20) Is there a list of good Ada books? Just for a list of texts, etc. (no evaluations or recommendations), you might take a look at the ADABOOKS.HLP file on the AdaIC Bulletin Board and in the public/ada-info directory on the AJPO host (ajpo.sei.cmu.edu). Books for use in class (and others): (from mfeldman@seas.gwu.edu (Michael B. Feldman)) As co-chair of the SIGAda Education Committee, and a denizen of the Internet newsgroups, I am often asked to give references for "Ada textbooks." This list responds to these many queries. It is far from exhaustive, merely a selected list of 26 books being used successfully in undergraduate computer science courses. The six books in the Group 1 are written especially for students without programming experience, who are learning Ada as their first language. Most of these can also cover at least part of a typical CS2-level course. The seven books in Group 2 use Ada as their language of discourse but are "subject-oriented:" data structures, file structures, compilers, comparative languages. The thirteen books in Group 3 are either "Ada books" focusing on the language features or more general books that use Ada, at least in part, but do not fit obviously into a standard curriculum "pigeonhole." I invite you to add to the list. Please write your annotated entry in the form I have used here and write or e-mail it to me. I will include it in my next version and credit you as a co-compiler of the list. Disclaimers: I wrote two of the texts listed here; I hope the annotations are impartial enough. And any annotated bibliography is selective and opinionated. Your mileage may vary. Group 1: Books Suitable for a First Course in Programming Bover, D.C.C., K.J. Maciuas, and M.J. Oudshoorn. Ada: A First Course in Programming and Software Engineering. Addison-Wesley, 1992. This work is, to our knowledge, the first Ada book to emerge from Australia, from a group of authors with much collective experience in teaching Ada to first-year students. A number of interesting examples are presented, for example, an Othello game. The book is full of gentle humor, a definite advantage in a world of dry and serious texts. In the book's favor is the large number of complete programs. On the other hand, it is rather "European" in its terseness; American teachers may miss the pedagogical apparatus and "hand-holding" typically found in today's CS1 books. Generic units are hardly mentioned. Culwin, F. Ada: a Developmental Approach. Prentice-Hall, 1992. This work introduces Ada along with a good first-year approach to software development methodology. Much attention is paid to program design, documentation, and testing. Enough material is present in data structures and algorithm analysis is present to carry a CS2 course. A drawback of the book is that the first third is quite "Pascal-like" in its presentation order: procedures, including nested ones, are presented rather early, and packages are deferred until nearly the middle of the book. This is certainly not a fatal flaw, but it will frustrate teachers wishing a more package-oriented presentation. The programs and solutions are apparently available from the author. Feldman, M.B., and E.B. Koffman. Ada: Problem Solving and Program Design. Addison-Wesley, 1991. This work combines the successful material from Koffman's CS1 pedagogy with a software-engineering-oriented Ada presentation order. Packages are introduced early and emphasized heavily; chapters on abstract data types, unconstrained arrays, generics, recursion, and dynamic data structures appear later. The last five chapters, combined with some language-independent algorithm theory, can serve as the basis of a CS2 course. A diskette with all the fully-worked packages and examples (about 180) is included; the instructor's manual contains a diskette with project solutions. Savitch, W.J. and C.G. Petersen. Ada: an Introduction to the Art and Science of Programming. Benjamin/Cummings, 1992. This is a straightforward adaptation of the well-known Savitch Pascal books. Ada is introduced in a Pascal-like order, with subtypes and packages introduced halfway through the book. This is purely a CS1 book. The final chapter covers dynamic data structures. There is no coverage of unconstrained array types; generics are introduced at the halfway point to explain Text_IO, then dropped until the final chapter. The authors intended this book to provide a painless transition to Ada for teachers of Pascal; one wishes they had taken advantage of the chance to show some of the interesting Ada concepts as well. Program examples from the text are available on disk, but only as part of the instructor's manual; a solutions disk is available for a fee from the authors. Skansholm, J. Ada from the Beginning. Addison Wesley, 1988. This book was one of the first to use Ada with CS1-style pedagogy. There are excellent sections on the idiosyncracies of interactive I/O (a problem in all languages), and a sufficient number of fully-worked examples to satisfy students. Generics, linked lists and recursion are covered at the end; there is no tasking coverage, but one would not expect this at CS1-level. Volper, D., and M. Katz. Introduction to Programming Using Ada. Prentice-Hall, 1990. This book uses a heavily "spiraled" approach to Ada, and is designed for a 2-semester course, covering nearly all of Ada eventually. There are lots of fully-coded examples, and good pedagogical sections on testing, coding style, etc. If you like spiraling, you'll like this. The down side is that you can't find all you need on a given subject in one place. It's at the other end of the scale from the "Ada books" that follow the Ada Language Reference Manual (LRM) order. Group 2: Other Books Intended for Undergraduate Courses Ben-Ari, M. Principles of Concurrent and Distributed Programming. Prentice-Hall 1990. (OS/concurrency) In my opinion, this is the best introduction to concurrency on the market. Ada notation is used for everything, but the focus is on concurrency and not on Ada constructs per se. I liked the CoPascal notation of the first edition better, but this book is still great. A software disk is promised in the preface; I had to work quite hard to get it from the publisher, which finally had to express-ship it from England. The software comes with a tiny Ada-ish interpreter, complete with Pascal source code, adapted from Wirth's Pascal/S via CoPascal. There are also some real Ada programs, most of which I've tested and found correct and portable. Feldman, M.B. Data Structures with Ada. Prentice Hall, 1985 (now distributed by Addison-Wesley). (CS2/data structures) This book is a reasonable approximation to a modern CS2 book: "big O" analysis, linked lists, queues and stacks, graphs, trees, hash methods, and sorting, are all covered. The Ada is a bit old-fashioned, especially the lack of generics; the book was published before compilers could handle generics. The packages and other programs are available free from the author. The book is currently under revision with Addison-Wesley and should appear in 1993. Fischer, C., and R. LeBlanc. Crafting a Compiler. Benjamin Cummings, 1988. (compilers) This book uses Ada as its language of discourse and Ada/CS, a usefully large Ada subset, as the language being compiled. If you can get the "plain Pascal" tool software by ftp from the authors, you'll have a good translator-writing toolset. Skip the Turbo Pascal diskette version, which is missing too many pieces to be useful. I've used the book since it came out with both undergrad and graduate compiler courses; it embodies a good blend of theory and "how it's really done" coding. Students like it. The authors have recently published a second version, which uses C as its coding language but retains Ada/CS as the language being compiled. Lomuto, N. Problem-Solving Methods with Examples in Ada. Prentice-Hall, 1987. (algorithms) Inspired by Polya's classic How to Solve It, this book can make a nice addition to an Ada-oriented algorithms course. It makes too many assumptions about students' programming background to use as a CS1 book, and doesn't teach enough Ada to be an "Ada book." But it makes nice reading for students sophisticated enough to handle it. I'd classify it as similar to Bentley's Programming Pearls. Miller, N.E. and C.G. Petersen. File Structures with Ada. Benjamin/Cummings, 1990. (file structures) Designed for a straightforward ACM-curriculum file structures course, this book succeeds at what it does. There are good discussions of ISAM and B-tree organizations. The software can be purchased a low cost from the authors; it seems to approximate in Ada all those C-based file packages advertised in programmer-oriented trade publications. Schneider, G.M., and S.C. Bruell. Concepts in Data Structures and Software Development (with Ada Supplement by P. Texel). West, 1991. (CS2/data structures) This work is not, strictly speaking, an Ada book; rather, it is a solid, language-independent approach to modern CS2. The language of discourse in the book is a Pascal-like ADT language rather like Modula-2 in style; some examples are coded in legal Pascal. The Ada supplement makes it usable in an Ada-based course, but the supplement is rather too terse (100 pages of large type) for my taste, and insufficiently well keyed to the book chapters. The supplement's effectiveness would be greatly enhanced by full translations to Ada of a large number of the book's examples. Sebesta, R.W. Concepts of Programming Languages. Benjamin Cummings, 1989. (comparative languages) If you've been around for a while, you might remember the late Mark Elson's 1975 book by the same title. This is similar: a concept-by- concept presentation, with -- in each chapter -- examples taken from several languages. There is a nice impartial presentation of Ada along with the others. I especially like the chapters on abstraction and exception handling. The book covers -- comparatively, of course -- most of the lanuages you'd like to see, including C, Lisp, Smalltalk, etc., with nice historical chapters as well. The book is readable; my students like it. Our undergraduate and graduate courses both use it as a base text. Group 3: A Selection of Other Ada-Related Books Barnes, J. Programming in Ada. (3rd edition) Addison Wesley, 1989. Barnes' work has been one of the most popular "Ada books." Some students find it hard to see how the pieces fit together from Barnes' often fragmentary examples; it is difficult to find complete, fully- worked out, compilable programs. A version is available with the entire Ada Language Reference Manual bound in as an appendix. Booch, G. Object-Oriented Design, with Applications. Benjamin Cummings, 1991. This is a good comparative introduction to the "object-oriented (OO)" concept. The first half gives a balanced presentation of the issues in OO Design; the second half gives nontrivial examples from Ada, Smalltalk, C++, CLOS, and Object Pascal. The author tries to sort out the difference between object-based (weak inheritance, like Ada) and object-oriented (like C++) languages. My only real complaint is that Booch should have worked out at least some of his case studies using several different languages, to highlight the similarities and differences in the language structures. As it is, each case study is done in only a single language. The good news is that the book is remarkably free of the hyperbolic claims one sometimes finds in the OO literature. I think this book could be used successfully in a second- level comparative languages course. Booch, G. Software Components with Ada. Benjamin Cummings, 1987. This work is an encyclopedic presentation of data structure packages from Booch's OOD point of view. It is great for those who love taxonomies. It's not for the faint-hearted, because the volume of material can be overwhelming. It could serve as a text for an advanced data structures course, but it's thin in "big O" analysis and other algorithm-theory matters. The book is keyed to the (purchasable) Booch Components. Booch, G. Software Engineering with Ada. (2nd edition) Benjamin Cummings 1987. Another of the classical "Ada books." Introduces Booch's OOD ideas. Not for use to introduce Ada to novices, in my opinion; there are some nice fully-worked case studies but they begin too far into the book, after long sections on design, philosophy, and language elements. The earlier chapters contain too much fragmentary code, a common flaw in books that follow the LRM order. Bryan, D.L., and G.O. Mendal. Exploring Ada, Volumes 1 and 2. Prentice-Hall, 1990 and 1992 respectively. This is an excellent study of some of the interesting nooks and crannies of Ada; it sometimes gets tricky and "language-lawyerly." Volume 2 takes up tasking, generics, exceptions, derived types, scope and visibility; Volume 1 covers everything else. The programs are short and narrowly focused on specific language issues. If you like Bryan's "Dear Ada" column in Ada Letters, you'll like this book. It is certainly not a book for beginners, but great fun for those who know Ada already and wish to explore. Burns, A. Concurrent Programming in Ada. Cambridge University Press, 1985. I used this book for years in my concurrency course. It's roughly equivalent to Gehani's book, but its age is showing. Cambridge Press is not always easy to get books from, especially in the US. Cohen, N. Ada as a Second Language. McGraw Hill, 1986. This book is a quite comprehensive exploration of Ada which follows the LRM in its presentation order. My graduate students like it because it is more detailed and complete than alternative texts. It's an excellent book for students who know their languages and want to study all of Ada. There are good discussions of "why's and wherefore's" and many long, fully-worked examples. Gauthier, M. Ada: Un Apprentissage (in French). Dunod, 1989. I found this an especially interesting, almost philosophical approach to Ada. The first section presents Ada in the context of more general laguage principles: types, genericity, reusability. The second section introduces testing and documentation concerns, as well as tasking; the third considers generics and variant records in the more general context of polymorphism. For mature Ada students in the French-speaking world, and others who can follow technical French, this book can serve as a different slant on the conventional presentations of the language. An English translation would be a real contribution to the Ada literature. Gehani, N. Ada: an Advanced Introduction (2nd edition). Prentice-Hall, 1989. I've always liked Gehani's literate writing style; he knows his languages and treats Ada in an interesting, mature, and balanced fashion. This book comes with a diskette sealed in the back of the book, which is advantageous because the book has numerous nontrivial, fully- worked examples. Gehani, N. Ada: Concurrent Programming (2nd edition). Silicon Press, 1991. This is a less formal, more Ada-oriented presentation of concurrency than the Ben-Ari work. I use both books in my concurrency course; its real strength is the large number of nontrivial, fully worked examples. Gehani offers a nice critique of the tasking model from the point of view of an OS person. The preface promises the availability of a software disk from the publisher. Nyberg, K. The Annotated Ada Reference Manual. (2nd edition) Grebyn Corporation, 1991. This is the definitive work on Ada legalities, because it presents not only the full text of the LRM but also the official Ada Interpretations. These commentaries, interleaved with the LRM text, have been approved and promulgated by the Ada Board and the various standards organizations, and are binding upon compiler developers. I recommend this book as an essential volume in the library of every serious Ada enthusiast. Shumate, K. Understanding Ada. (2nd edition) John Wiley, 1989. This would make a CS1 book if it included more overall pedagogy, independent of language constructs. Otherwise it is a nice introduction to Ada in fairly gentle steps. Lots of completely worked examples, right from the start. Doesn't follow the LRM order, which is great. Watt, D.A., B.A. Wichmann, and W. Findlay. Ada Language and Methodology. Prentice-Hall, 1987. This work presents some interesting programming projects, and the coverage of design and testing--at the level of a first-year student--is quite good. The first third of the book concentrates heavily on classical control and data structures, leaving exceptions and packages until the "programming in the large" material in the second third. CS2 teachers will find too little concentration on algorithm analysis. On the other hand, tasking and machine-dependent programming are covered. Like the Shumate work, this book would make a suitable introduction to Ada for students with a semester or so of programming experience; it "jumps in" too quickly to satisfy the needs of neophytes and is not well-tailored to CS1 or CS2 needs. 21) Where can I get language translators? The AdaIC maintains a Products and Tools Database on its bulletin board (703/614-0215), and one of the categories is translators. (The list of products should not be considered exhaustive; if you wish to suggest additions, please contact the AdaIC.) Besides access to the database via the bulletin board, you can also call the AdaIC (800-AdaIC-11 or 703/685-1477) and ask for a customized search. In addition to all the usual caveats, however, it should also be noted that translation itself is a controversial issue. When a project makes the transition to Ada from some other language, one question that arises is whether to translate older code into Ada. Among the immediate considerations are how much of the code can in fact be translated by a program intended for that purpose, versus how much will still require re-coding by hand. And will the translated code will suffer a significant loss in speed of execution? Further, a project must consider whether the translated code will reflect sound software engineering and be readily understandable and modifiable. Or will it be merely "Fortranized Ada" or "Cobolized Ada", or the like, possibly retaining limitations present in the earlier code? Portability is also a problem. The resolution of such issues will require an understanding of the earlier code, an appreciation of the similarities and differences between its language and Ada, and an evaluation of the translation program under consideration. 22) What is the status of the POSIX/Ada work? (from emery@mitre.org (dave emery)) The IEEE approved IEEE Standard 1003.5-1992 in June 1992. This is the Ada Binding to the facilities defined in ISO 9945-1:1989/IEEE 1003.1-1990, the POSIX System Services. IEEE Standards Committee P1003.5 is now working on Ada bindings to IEEE draft standards 1003.4, Real-Time Extensions and 1003.4a, Threads Extensions. Current plans call for an IEEE ballot in October 1993, with IEEE approval in September 1995. For more information, contact the P1003.5 Chairman, Jim Lonjers (lonjers@vfl.paramax.com, 805/987-9457). 23) How can I get a copy of POSIX/Ada? Is it available via FTP? (from emery@mitre.org (dave emery)) You can buy a copy of the standard from the IEEE. The order number is "SH 15354", and the mailing address is "IEEE Service Center, 445 Hoes Lane, Piscataway, NJ 08855-1331". They will accept credit-card orders at 1-800/678-4333. The cost is $62.50 + $5.00 s/h ($43.75 + $4.00 s/h for IEEE Members). Current IEEE policy prohibits electronic distribution of IEEE standards. Proceeds from the sale of IEEE standards help support the IEEE standards program. The POSIX P1003.5 committee is trying to work out an arrangement with the IEEE to make the POSIX/Ada package specifications available for distribution via email and anonymous FTP. 24) Where can I get Ada benchmark programs? In addition to the information below, you may also wish to look at the AdaIC flyer "How to Obtain Benchmark Performance Test Suites and Results", flyer V15, file benchmrk.hlp. on the AJPO Host (ajpo.sei.cmu.edu). For more on the AdaIC and downloading files, see questions 14), 15), and 25). (from pd@SEI.CMU.EDU (Patrick Donohoe)) The Ada Evaluation System: The Ada Evaluation System (AES) may be obtained from the British Standards Institute at the following address: Software Product Services Software Engineering Department BSIQA P.O. Box 375 Milton Keynes MK14 6LL United Kingdom Tel: 0908 220908 UUCP: sed@bsiqa.uucp (Internet: bsiqa!sed@uunet.uu.net) As of February 1993, the current version is the DIY-MAPSE-01 version. It is available at a cost of 3,000 pounds sterling. BSI also offers a validation service at a cost of 24,000 pounds sterling. Principal documents are a User's Manual, a Reference Manual, and a Test Description Document. The Ada Evaluation System (AES) will be merged with the Ada Compiler Evaluation Capability (ACEC) under a joint agreement between the Ministry of Defence of the United Kingdom and the Department of Defense of the United States that was signed in June of 1991. The merged product will be released as version 4.0 of the ACEC; as of March 1993, the expected release time was the third or fourth quarter of 1993. The Ada Compiler Evaluation Capability: The Ada Compiler Evaluation Capability (ACEC) may be obtained from: Data and Analysis Center for Software (DACS) P.O. Box 120 Utica, NY 13503 Tel: 315/734-3696 Internet: dacs-info@kaman.com As of February 1993, the current release of the ACEC is 3.0. There are three documents: the User's Guide, the Reader's Guide, and the Version Description Document. The total cost for the software and documentation is 100 US dollars. (Release 3.0 of the ACEC is not the merged AES-ACEC product referred to above.) Hartstone Benchmarks: Electronic mail requests for Hartstone should be sent to the following Internet address: hartstone-info@sei.cmu.edu The reply message will contain full details of how to obtain source code and documentation by various means, including anonymous ftp. There is no charge for the Hartstone source code. For people without Internet access, the address to send requests to is: REST Transition Services Software Engineering Institute Carnegie Mellon University Pittsburgh, PA 15213-3890 Phone: 412/268-7787 Hartstone source code may also be retrieved from the PIWG bulletin board. (See below.) The PIWG Benchmarks: The ACM Performance Issues Working Group (PIWG) benchmarks may be obtained in one of three ways: 1. Via anonymous ftp from the ajpo.sei.cmu.edu machine. Users should issue the command "ftp ajpo.sei.cmu.edu" and log in using the word "anonymous" as the login name and an identifying string (e.g., the user's e-mail address) as password. Change directory ("cd" command) to the "public/piwg/piwg_11_92" directory and use the ftp file-transfer commands to retrieve the files. The README file contains information about using the benchmarks. 2. Via the PIWG bulletin board. Ideally, users should access this from a PC (rather than a dumb terminal) using a modem capable of sending and receiving at 1200 baud or higher. The number of the bulletin board is 412/268-7020. Once connected to the bulletin board, users will be able to navigate their way around the system using simple menus that the system provides. The point of contact for this service is Gene Rindels, 412/268-6728. 3. Via a written request or telephone request to the following service: PIWG Distribution Software Engineering Institute Carnegie Mellon University Pittsburgh, PA 15213-3890 Tel: 412/268-7787 As of February 1993, the current release of the PIWG suite is the one dated 11/92. There is no charge for the PIWG benchmarks. Documentation for the PIWG benchmarks consists principally of the READ.ME file distributed with the suite and comments in the individual test programs and command files. There is also additional information about the PIWG suite in the Winter 1990 special edition of Ada Letters (Vol. X, No. 3, special edition on Ada Performance Issues). 25) The AJPO host has a lot of Ada information files available for downloading by anonymous FTP. But I don't have FTP service on the Internet host where I have an account. Is there any way I can get those files? The AJPO host, ajpo.sei.cmu.edu, will provide mail-server capabilities on an experimental basis. The available services provided by this automatic mail server are: services, Re, help, info, man, directory, and file-request. To request a service, send e-mail to "ftpmail@ajpo.sei.cmu.edu" and place its name in the Subject line of the mail message, followed by any needed parameters. The mail server will respond to your request with either the information you requested or an error message. The following are common examples on how to request services from the AJPO host mail server: ---------------------------------------------------------------------- 1) To get "help" -- To: ftpmail@ajpo.sei.cmu.edu Subject: help ---------------------------------------------------------------------- 2) To get "man" pages of a particular service, such as "directory" -- To: ftpmail@ajpo.sei.cmu.edu Subject: man directory This service takes as a parameter the name of a service, and returns a manual page on that service. ---------------------------------------------------------------------- 3) To get a "directory" listing of the AJPO anonymous ftp area (/public) -- To: ftpmail@ajpo.sei.cmu.edu Subject: directory The "directory" service takes as an optional parameter a file or directory name, and returns the results of an "ls -l" on that parameter. For example, to get a listing of the /public/ada-info directory you would submit a message with the Subject of: Subject: directory ada-info The filename pattern may include wildcards as defined by the C shell. For example, to get a listing of the /public directories beginning with "p" you would submit a message with the Subject of: Subject: directory p* ---------------------------------------------------------------------- 4) Use "file-request" to get /public/README file -- To: ftpmail@ajpo.sei.cmu.edu Subject: file-request README The "file-request" service takes as an optional parameter a filename, and will return the contents of the file. Text files are returned verbatim, while binary files are encoded via the Unix "uuencode" command. Large files (greater than 1000 lines long) will be split into multiple mail messages. For example, to get the file "README" in the /public/ada-info directory you would submit a message with the Subject of: Subject: file-request ada-info/README ---------------------------------------------------------------------- Below is a sample response to a "help" request. From: FTP Mail Server Message-Id: <9301141628.AA26473@ajpo.sei.cmu.edu> To: adainfo@ajpo.sei.cmu.edu Subject: Re: help In-Reply-To: <9301141628.AA26462@ajpo.sei.cmu.edu> Content-Type: text/plain; charset=us-ascii You have sent electronic mail to the Ada Joint Programs Office automatic mail server. This server is based on the ServiceMail(tm) Tookit from Enterprise Integration Technologies. In general, you may request a service by placing its name in the Subject line of a mail message, followed by any needed parameters. The mail server will respond to your request with either the information you requested or an error message. Here is a brief description of the available services: services: This service returns a list of the available services. Re: This service discards all messages with "Re:" in the subject line. This is to prevent mail loops. help: This service returns this help message. info: This service returns this help message. man: This service takes as a parameter the name of a service, and returns a manual page on that service. directory: This service takes as an optional parameter a file or directory name, and returns the results of an "ls -l" on that parameter. The root of the file structure is the AJPO anonymous FTP area. file-request: This service takes as an optional parameter a file name, and will return the contents of the file. The root of the file structure is the AJPO anonymous FTP area. Text files are returned verbatim, while binary files are encoded via the Unix "uuencode" command. Large files (greater than 1000 lines long) will be split into multiple mail messages. Try 'man ' to get more information on a particular service. Please report bugs and other problems to ftpmail-request@ajpo.sei.cmu.edu. ====================================end=======================================