From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: "Andrew Trevors" Newsgroups: gmane.emacs.devel Subject: Documentation Question Date: Mon, 2 Dec 2002 12:43:40 -0500 Sender: emacs-devel-admin@gnu.org Message-ID: <00e301c29a2a$59f53020$444f6181@swag07> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Trace: main.gmane.org 1038851600 17339 80.91.224.249 (2 Dec 2002 17:53:20 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Mon, 2 Dec 2002 17:53:20 +0000 (UTC) Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 18IuYH-0003h3-00 for ; Mon, 02 Dec 2002 18:40:13 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 18IuhO-00082R-00 for ; Mon, 02 Dec 2002 18:49:38 +0100 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18IuY8-00068g-00; Mon, 02 Dec 2002 12:40:04 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 18IuXq-0005rv-00 for emacs-devel@gnu.org; Mon, 02 Dec 2002 12:39:46 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 18IuXo-0005rU-00 for emacs-devel@gnu.org; Mon, 02 Dec 2002 12:39:45 -0500 Original-Received: from pythagoras.math.uwaterloo.ca ([129.97.140.122]) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18IuXo-0005p1-00 for emacs-devel@gnu.org; Mon, 02 Dec 2002 12:39:44 -0500 Original-Received: from swag07 (swag07.uwaterloo.ca [129.97.79.68]) by pythagoras.math.uwaterloo.ca (8.9.3/8.9.3) with SMTP id MAA18829 for ; Mon, 2 Dec 2002 12:39:42 -0500 (EST) Original-To: X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 6.00.2800.1106 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1106 Errors-To: emacs-devel-admin@gnu.org X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.0.11 Precedence: bulk List-Help: List-Post: List-Subscribe: , List-Id: Emacs development discussions. List-Unsubscribe: , List-Archive: Xref: main.gmane.org gmane.emacs.devel:9806 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:9806 Sorry to post a non-development question here but I figured that this mailing list would have the answers I need. I am a graduate student at a university in Ontario, Canada. I am taking part in the teaching of a course on Software Architecture. We will be using GNU Emacs as a guinea pig this coming semester (we've used Linux, Vim, Apache, Mozilla, Nautilus, PostgreSQL, mySQL, and a wealth of other open source software). The idea is to study the architecture (high level components, e.g. subsystems, and their interactions) of a real system by first formulating a conceptual architecture (the as-designed view as the developers see it) and then extracting a concrete architecture (the as-implemented view) and then comparing them, and suggesting ways to repair the architecture (the two should be the same, but they are often not). Now, why I've posted this here is that I haven't had much luck finding any design type documentation that could be used to formulate a conceptual architecture. Is there any sort of docs or anything that is used to teach new programmers to the project, or is this type of thing usually up to the programmer himself by reading through code/comments. Thanks for any help you can give me. If I have offended or annoyed anybody by posting here, I apoligize and I'm sorry. Andrew Andrew Trevors BCS (UNB) MMath I Graduate Student, Software Architecture Group School of Computer Science University of Waterloo