View of /trunk/webwork2/doc/TODO

    1 ################################################################################
    2 # WeBWorK mod_perl (c) 2000-2002 WeBWorK Project
    3 # $Id: TODO,v 1.4 2002-08-21 18:31:16 sh002i Exp $
    4 ################################################################################
    5 
    6 Son of WeBWorK - TODO list
    7 
    8 OK	write template file from what we drew on the board
    9 OK	normalize files:
   10 		- (c) header on all files
   11 		- standard order of preamble lines:
   12 			1. (c) header
   13 			
   14 			2. package PACKAGENAME;
   15 			
   16 			3. short summary of the package (pod's NAME section)
   17 			
   18 			4. use - pragmatic modules
   19 			5. use - standard perl modules
   20 			6. use - CPAN modules
   21 			7. use - webwork modules
   22 		- ALWAYS use strict and use warnings
   23 		- use "use base" rather than "our @ISA"
   24 		- no warnings or errors!
   25 		- (later on) POD documentation for all files
   26 OK	fix templating code in ContentGenerator, add new escape functions
   27 OK	implement the new template
   28 OK	finish ProblemSets and ProblemSet
   29 	
   30 --------------------------------------------------------------------------------
   31 	
   32 	New interface to PG.pm
   33 		- instead of it accessing the database directly, accept $user,
   34 		  $set, and $problem as arguments (instead of $setName, etc.)
   35 		- Fix Problem.pm and Hardcopy.pm to work with the new interface
   36 	
   37 	Hardcopy generation
   38 		- ad-hoc version of &latex2png in Hardcopy.pm (move later)
   39 		- fix 
   40 	
   41 	Calling LaTeX/dvipng and PDFLaTeX in a nice way
   42 		- create LaTeX.pm (?)
   43 		- &latex2pdf
   44 			- create secure tempdir
   45 			- write hardcopy to tex file
   46 			- call pdflatex
   47 			- move resulting pdf file to tmp/hardcopy/whatever.pdf
   48 			- remove tempdir
   49 		- &latex2png (dvipng method)
   50 			- create secure tempdir
   51 			- write equations to tex file
   52 			- call latex
   53 			- run dvipng (as per ImageGenerator) on dvi file
   54 			- move resulting images to tmp/dvipng/whatever.png
   55 			- remove tempdir
   56 	
   57 	Integration of dvipng method of image generation
   58 		- who the fuck knows...
   59 		- choice between writing to a temporary TeX file from within
   60 		  dangerousMacros, or queueing the equations up in RAM and
   61 		  passing them out to the caller (via PG_flags?) who will then
   62 		  call &latex2png
   63 		- write tempfile from dangerousMacros
   64 			- PRO: gets it out of RAM
   65 			- PRO: no dependancies between equations
   66 			- CON: have to coordinate between latex2png and
   67 			       dangerous macros for tempfile locations
   68 		- queue equations in RAM
   69 			- PRO: all file access and external calls happen
   70 			       outside of the safe compartment.
   71 			- PRO: latex2png gets to decide where to put files
   72 			- CON: stuff sits in RAM
   73 			- CON: uses a package array to queue equations :p
   74 			
   75 	
   76 	display of screen set header in ProblemSet.pm
   77 	display of screen problem header in Problem.pm
   78 	Options (email address and password)
   79 	PG.pm handling of "problem 0"
   80 	handling of PG warnings (?!?!?!?!)
   81