doc/latex

git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751

4 files changed, 204 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/qcm/NEWS b/Master/texmf-dist/doc/latex/qcm/NEWS
new file mode 100644
index 00000000000..e0f920b3490
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/qcm/NEWS
@@ -0,0 +1,42 @@
+
+
+			      WHAT'S NEW IN QCM
+
+
+
+*** Copyright (C) 2004 Didier Verna
+
+This file is part of QCM.
+
+QCM may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either version 1.1
+of this license or (at your option) any later version.
+The latest version of this license is in
+http://www.latex-project.org/lppl.txt
+and version 1.1 or later is part of all distributions of LaTeX
+version 1999/06/01 or later.
+
+QCM consists of the files listed in the file `README'.
+
+* Version 2.1
+=============
+** QCM now provides a "correction" mode
+In this mode, correct / wrong answers are labeled differently, and an
+explanation text can be typeset below each question.
+
+* Version 2.0
+=============
+** QCM now comes both in class and style form.
+You can use the style with any class you want. The class is a wrapper around
+the style for simple exams involving only multiple choice questions.
+
+* Version 1.0
+=============
+** First public release.
+
+
+
+
+Local Variables:
+mode: outline
+End:
diff --git a/Master/texmf-dist/doc/latex/qcm/README b/Master/texmf-dist/doc/latex/qcm/README
new file mode 100644
index 00000000000..1bddcfd1b8e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/qcm/README
@@ -0,0 +1,68 @@
+	      This is the README file for QCM, a LaTeX2e package
+		  for making Multiple Choices Questionaires
+
+                       Copyright (C) 2004 Didier Verna
+
+
+* Copyright
+===========
+
+This file is part of QCM.
+
+QCM may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either version 1.1
+of this license or (at your option) any later version.
+The latest version of this license is in
+http://www.latex-project.org/lppl.txt
+and version 1.1 or later is part of all distributions of LaTeX
+version 1999/06/01 or later.
+
+QCM consists of the following files:
+
+- README (this file)
+- NEWS
+- qcm.ins
+- qcm.dtx
+- qcm.el
+
+
+* Description
+=============
+
+QCM is a package for making multiple choices questionnaires ("QCM" is the
+corresponding French acronym) under LaTeX2e. A special environment allows you
+to define questions and possible answers. You can specify which answers are
+correct and which are not. QCM not only formats the questions for you, but
+also generates a "form" (a grid that your students will have to fill in), and
+a "mask" (the same grid, only with correct answers properly checked in). You
+can then print the mask on a slide and correct the questionnaires more easily
+by superimposing the mask on top of students' forms. QCM can also typeset
+exams corrections automatically, and comes with support for AUC-TeX.
+
+
+* Installation
+==============
+
+	To install the package, please follow these steps:
+
+- Run LaTeX on the file `qcm.ins' to create the files `qcm.cls' and `qcm.sty'.
+- Run LaTeX on the file `qcm.dtx' to create the doc   file `qcm.dvi'.
+- Install these files anywhere you see fit.
+
+	If you're an AUC-TeX user, you can also install the file `qcm.el' in
+a suitable AUC-TeX style directory.
+
+	Have fun!
+
+--
+Didier Verna, didier@lrde.epita.fr, http://www.lrde.epita.fr/~didier
+
+EPITA / LRDE, 14-16 rue Voltaire   Tel.+33 (1) 44 08 01 85
+94276 Le Kremlin-Bicêtre, France   Fax.+33 (1) 53 14 59 22   didier@xemacs.org
+
+
+
+
+Local Variables:
+mode: outline
+End:
diff --git a/Master/texmf-dist/doc/latex/qcm/qcm.el b/Master/texmf-dist/doc/latex/qcm/qcm.el
new file mode 100644
index 00000000000..10def20e2a5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/qcm/qcm.el
@@ -0,0 +1,94 @@
+;;; qcm.el --- AUC-TeX style file for QCM
+
+;; Copyright (C) 2004 Didier Verna.
+
+;; Author:        Didier Verna <didier@lrde.epita.fr>
+;; Maintainer:    Didier Verna <didier@lrde.epita.fr>
+;; Created:       Tue Apr 18 14:49:29 2000
+;; Last Revision: Tue Nov  9 17:46:37 2004
+;; Keywords:      tex abbrev data
+
+;; This file is part of QCM.
+
+;; QCM may be distributed and/or modified under the
+;; conditions of the LaTeX Project Public License, either version 1.1
+;; of this license or (at your option) any later version.
+;; The latest version of this license is in
+;; http://www.latex-project.org/lppl.txt
+;; and version 1.1 or later is part of all distributions of LaTeX
+;; version 1999/06/01 or later.
+
+;; QCM consists of all files listed in the file `README'.
+
+
+;;; Commentary:
+
+;; Contents management by FCM version 0.1-b2.
+
+;; #### NOTE: maybe this file should be split in two: one for the style and
+;; #### one for the class.
+
+;;; Code:
+
+(defun qcm-LaTeX-item-question ()
+  (if current-prefix-arg
+      (TeX-insert-macro "true")
+    (TeX-insert-macro "false")))
+
+(push '("question" . qcm-LaTeX-item-question) LaTeX-item-list)
+
+(defun qcm-LaTeX-env-question (environment)
+  "Create a \`question' environment in a QCM document."
+  ;; Questions can be quite long, so instead of prompting for them, which
+  ;; would be annoying, let's just put the point inside the braces.
+  (LaTeX-insert-environment environment "{}")
+  (beginning-of-line)
+  (kill-line)
+  (LaTeX-find-matching-begin)
+  (end-of-line)
+  (forward-char -1)
+  )
+
+(TeX-add-style-hook "qcm"
+  (function
+   (lambda ()
+     ;; QCM style:
+     (LaTeX-add-environments
+      '("question" qcm-LaTeX-env-question)
+      '("correction")
+      )
+     (TeX-add-symbols
+      '("true" (TeX-arg-literal " "))
+      '("false" (TeX-arg-literal " "))
+      '("truesymbol" t)
+      '("falsesymbol" t)
+      '("correctionstyle" t)
+      '("questionspace")
+      '("thequestion")
+      '("answerstitle" t)
+      '("answerstitlefont" t)
+      '("answernumberfont" t)
+      '("makeform")
+      '("makemask")
+      '("headerfont" t)
+      '("X" t)
+      ;; QCM Class:
+      '("title" t)
+      '("titlefont" t)
+      '("titlespace")
+      '("maketitle")
+      '("questiontitle" t)
+      '("questiontitlefont" t)
+      '("questiontitlespace")
+      '("questionsepspace")
+      )
+     )))
+
+
+
+
+;;; Local variables:
+;;; eval: (put 'TeX-add-style-hook 'lisp-indent-function 1)
+;;; End:
+
+;;; qcm.el ends here
diff --git a/Master/texmf-dist/doc/latex/qcm/qcm.pdf b/Master/texmf-dist/doc/latex/qcm/qcm.pdf
new file mode 100644
index 00000000000..a99751c7908
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/qcm/qcm.pdf