Index: WAeUP_Doc/OldDocumentation/HostelAllocation.rst
===================================================================
--- WAeUP_Doc/OldDocumentation/HostelAllocation.rst	(revision 3212)
+++ WAeUP_Doc/OldDocumentation/HostelAllocation.rst	(revision 3212)
@@ -0,0 +1,173 @@
+
+Hostel Allocation Process
+=========================
+
+
+Hostel Allocation Slip
+----------------------
+
+
+The fields needed for generating Hostel Allocation Slip are as follows:
+
+Student's Entry Registration No. 
+  (for new students, Matriculation No. for Old Students)
+
+Full Name
+
+Access PIN 
+  (the Scratch PIN purchased from a bank and used for the application)
+
+Sex
+  (eg. Male or Female)
+	
+Session
+  (Current Academic Session)
+	
+Course of Study
+  (e.g. Medicine, Pharmacy, Biochemistry, Law or Accounting)
+  
+Level of Study 
+  (100, 200, 300, 400, 500 or 600 depending on the course of study)
+
+Then the details of the hostel allocation comprising:
+
+Date of Allocation
+  (This is the date the reservation was made)
+
+Name of Residence Hall
+	
+Block 
+
+Room Number
+
+Bed Space Allocated
+
+Annotation/Note
+  This is to affirm that you have been allocated a room in the hostel,
+  details as shown above. Please print this Allocation Slip and keep for Hostel Clearance
+
+
+Hostel Categories
+-----------------
+    
+The Hostel Categories are as follows:
+
+- Ugbowo Campus (Main Campus)
+
+  1. Hall One:  For all Categories of Female Students
+  2. Hall Two:  For all Categories of Female Students
+  3. Hall Three: For all Categories of Male Students
+  4. Hall Four: For all Categories of Male Students
+  5. Hall Five: For only Final Year Male & Female Students
+  6. Medical Hostel: For all 500 & 600 Level Medical & Dental Students only
+ 
+- Ekehuan Campus (satellite campus)
+
+  1. Female Undergraduate Hall 
+  2. Male Undergraduate Hall 
+  3. Postgraduate Hostel: For all Male Postgraduate Students 
+  4. Postgraduate Female Hostel: For all Female Postgraduate Students
+
+
+Detailed Hostel Description
+---------------------------
+
+Hall One
+::::::::
+
+Consist of 7 Blocks labeled A,B,C.. & G, each Block consist of 30 rooms
+spread across three floors (10 rooms per floor). The first room on the
+Ground floor of Block A is numbered 101, the next 102, while the last room
+is labeled 110. The first room on the next floor is also labeled 201, next
+202 and the 10th room on that floor is 210. Each room has 6 bed spaces
+labeled A, B, C, D, E & F. Therefore, the first space to be allocated will
+Hall one, Block A, Room 101, Bed Space A. 
+
+Therefore, there are a total of 1,260 bed spaces in Hall One. (7 Blocks X 30
+rooms X 6 bed spaces).
+
+Hall Two
+::::::::
+ 
+This hall consist of 6 Blocks labeled A, B,C, D,E & F; each Block consist of
+40 rooms, each room has 8 bed spaces. The bed spaces are labeled exactly as
+described in Hall One above.
+
+Therefore, there are a total of 1,920 bed spaces in Hall One. (6 Blocks X 40
+rooms  bed spaces).
+
+
+Hall Three
+::::::::::
+
+Same as Hall Two
+
+Hall Four
+:::::::::
+
+This hall is divided into 3 Sections as follows:
+
+Section I 
+  has a total of 200 Rooms with 8 bed spaces in each room
+
+Section II 
+  has a total of 200 Rooms with 8 bed spaces in each room
+
+Section III
+  has a total of 147 Rooms with 8 bed spaces in each room
+
+Therefore, there are a total of 4,376 bed spaces in Hall Four.
+
+Hall Five
+:::::::::
+
+This hall of residence has two blocks, each has 100 bed spaces. One block accommodates
+final year male students while the other is for final  year female students.
+
+Medical Hostel
+::::::::::::::
+
+Has two blocks, each for male and female (500 & 600 Medical & Dental Students) with capacity  to accommodate 138 students each.
+
+Postgraduate Accommodation is currently being handled manually, I will give
+the details in my subsequent mail.
+
+
+Hostel Allocation Criteria
+--------------------------
+
+1. Only Full Time (Undergraduate & Postgraduate Students are entitled to
+Hostel Accommodation Allocation). 
+
+2. For all undergraduate hostel allocations, the available bed spaces are
+allocated as follows:
+
+ a) Bed Spaces A & B in halls one, two, three & four are meant for Final 
+    Year Students only.
+
+ b) Bed Space C in Hall One is strictly meant for Returning Students.
+
+ c) Bed Spaces D,E & F in Hall One are meant to be allocated to fresh students.
+
+ d) In Halls Two, Three and Four, Bed Spaces C & D are for Returning Students 
+    and E,F,G & H are for Fresh Students.
+
+
+3. Medical Hostel are allocated 500 & 600 Medical and Dental Students at a
+ratio 60:40 respectively.
+
+4. All the available bed spaces (A, B, C, D, E, F, G & H) in Hall Five are
+allocated to FINAL YEAR ONLY.
+
+5. Just before the commencement of Hostel Allocations, some reservations are
+made officially for Student Union Leaders, Sports Men and Women, Disabled or
+Physically-Challenged Students, etc. Therefore, there should be provision to
+make reservations at the back-end, and populate such reservations at a later
+date.
+
+6. The Hall of Residence attracts different charges, so students do not pay
+same amount for allocated spaces.
+
+7. The Hostel Application Fee is all the same irrespective of the Hall of
+Residence the student is seeking reservation, and it N500.00.
+
Index: WAeUP_Doc/OldDocumentation/InstructionsPart1.txt
===================================================================
--- WAeUP_Doc/OldDocumentation/InstructionsPart1.txt	(revision 3212)
+++ WAeUP_Doc/OldDocumentation/InstructionsPart1.txt	(revision 3212)
@@ -0,0 +1,51 @@
+Instructions Part 1
++++++++++++++++++++
+
+Set-up of the SRP instance on your local machine (for training purposes only)
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+1. Install Zope 2.9.3 on your local computer (Windows or Linux) 
+
+2. Make a Zope instance (type `python mkzopeinstance` in the bin folder of the Zope programme directory). You are advised to create an instance called srp in your home folder ('My Files' on Windows) not in the Zope programme directory.
+
+3. Download CPS 3.4.0-1 or the following release candidate: http://www.cps-project.org/static/src/CPS-3.4.1-rc.tar.gz and unpack the files into the Products folder of your Zope instance  created in 1.
+
+4. Checkout the WAeUP_SRP product from our svn: https://svn.waeup.org/repos/WAeUP_SRP/trunk. You can use TortoiseSVN on Windows or type `svn co https://svn.waeup.org/repos/WAeUP_SRP/trunk WAeUP_SRP` on Linux. You'll need your WAeUP user name and password for the checkout. The files should be copied into a folder called `WAeUP_SRP` inside of the Products folder of your Zope instance.
+
+5. Copy the Uniben csv data files into the import folder of your Zope instance. The csv files are attached to this email.
+
+6. Start Zope from the bin folder of your Zope instance with `./zopectl start` (background) or `./runzope` (foreground) on Linux or `runzope` on Windows. You can also start a Windows Service which runs in the background. For the latter you can use the following commands:
+
+ ::
+
+  python zopeservice.py install
+  python zopeservice.py start
+  python zopeservice.py stop
+  python zopeservice.py remove
+
+7. Open your browser and enter http://localhost:8080/manage. After entering your user name and password (defined in 2) the ZMI shows up. 
+
+8. Choose `CPSDefault Site` (nothing else!) in the pull-down menu and add.
+
+9. Fill the fields as follows:
+
+ ::
+
+  Site ID: srp
+  Site Title: Student Registration Portal
+  Administrator Login: your Zope instance user name
+  Password: your Zope instance password
+  Extensions: WAeUP_SRP only
+  Site Languages: English only
+
+10. Add the site
+
+11. Open a second browser window and enter http://localhost:8080/srp and you will see the frontpage of the portal.
+
+12. Login with your user name and password
+
+13. Goto Academics
+
+14. Import the Uniben data in the following order: Faculties (30 sec), Departments (1 min), Courses (15 min), Certificates (15 min), CertCourses (20 min). Be patient and wait.
+
+15. Ready
Index: WAeUP_Doc/OldDocumentation/InstructionsPart2.txt
===================================================================
--- WAeUP_Doc/OldDocumentation/InstructionsPart2.txt	(revision 3212)
+++ WAeUP_Doc/OldDocumentation/InstructionsPart2.txt	(revision 3212)
@@ -0,0 +1,93 @@
+Instructions Part 2
++++++++++++++++++++
+
+Usage of the SRP Backend Portal
++++++++++++++++++++++++++++++++
+
+
+Object hierarchy
+---------------- 
+
+Browse through the data and visit all levels which reflect the real structure of the University. The deepest level is the Certificate Course, for example BOT111 'Diversity of Plants' has the path:
+
+::
+
+   Academic Section 
+ > Faculty of Agriculture 
+ > Department of Agricultural Economics & Ext. Services 
+ > Certificates 
+ > BACHALOR OF AGRICULTURE (AGRIC ECONS) 
+ > Level 100 
+ > First Semester 
+ > Diversity of Plants
+
+..
+
+Also the URL reflects this hierarchy. It's a path along the Ids of the hierarchical ordered ancestor objects: 
+
+http://srp.waeup.org/campus/academics/AGR/AEE/certificates/BAGAEE/100/first/BOT111.
+
+For each Certificate Course there is a corresponding Course object. The Course objects are in the course folder of the department offering this course:
+
+::
+
+   Academic Section 
+ > Faculty of Life Sciences 
+ > Department of Botany 
+ > Courses 
+ > Diversity of Plants
+
+..
+
+or: http://srp.waeup.org/campus/academics/LSC/BOT/courses/BOT111
+
+At the moment there is no direct link to the Course source. But you can easily use the search function, e.g. search for BOT111, and you'll find not only the Course source itself but also all other Certificates referring to this course.
+
+The content types of all objects are ordered in the same way: 
+
+::
+
+ AcademicsFolder > FacultyFolder > DepartmentFolder > 
+        CoursesFolder > Course
+        CertificatesFolder > StudyLevel > Semester > CertificateCourse
+
+..
+
+The datastructure of the objects (also called attributes or properties) are defined by their content type. 
+
+
+Register new portal members and delegate roles
+----------------------------------------------
+
+1. As a Portal Managers you can register new members. Click the 'Members' tab in the navigation bar and then 'Create' in the horizontal object action bar. Enter the member data. Do not tick the Manager box. Create for example a member called ART Manager. 
+
+2. Go to the Faculty of Arts (Academics -> Faculty of Arts)
+
+3. Click 'Delegate'.
+
+4. Search for '*' 
+
+5. Tick Art Manager and assign the role 'Section Manager'. Now the member ART Manager has got the local manager role exclusively for the Faculty of Arts.
+
+6. Log out
+
+7. Log in as ART Manager and see the difference: If you go to the 'Faculty of Arts' you will be able to view the data, edit the data, delegate your role to other members, add a new department, approve the data or see a list of unchecked items inside the Faculty of Arts. The same functions are also available for all departments below the ART level. If you go to another faculty, only the 'View' tab appears. This shows how the delegation of roles works.
+
+
+Check and approve data
+----------------------
+
+Course and Certificate data have to be checked. Only checked data will be available for course registration in the frontend module.
+
+1. Go to any Certificate object and approve this object (Click the 'Approve' tab in the object action bar) . The status in the object action bar (on the right) will change from 'unchecked' to 'checked'. Be aware that only the certificate status has changed, not the status of the children objects, i.e. the CertificateCourses. Thus, do the same for the CertificateCourse and Course objects. 
+
+2. Alternatively, you can use the 'Select all' tab at the end of a contents table. For example, go to the list of courses of any department, click 'Select all' and then 'Approve'. The status of all objects in this list will change from 'unchecked' to 'checked'.
+
+3. If you want to see your 'worklist', i.e. all objects which are still unchecked inside the faculty or department where you currently are, click 'Unchecked Items'. Only when this list is empty, the work is done.
+
+Add data
+--------
+
+Probably many items are missing. You can add the respective data from the place where you are. Also these items have to be approved after creation.
+
+
Index: WAeUP_Doc/OldDocumentation/InstructionsPart3.txt
===================================================================
--- WAeUP_Doc/OldDocumentation/InstructionsPart3.txt	(revision 3212)
+++ WAeUP_Doc/OldDocumentation/InstructionsPart3.txt	(revision 3212)
@@ -0,0 +1,66 @@
+Instructions Part 3 
++++++++++++++++++++
+
+Testing the SRP Application Module 
+++++++++++++++++++++++++++++++++++
+
+1. Open your Firefox browser (IE is not recommended but does also work) and login as manager. You can do that either through the unben-local.waeup.org portal or through the uniben.waeup.org portal. The latter is recommended when opening the website from outside the btedu LAN on campus.
+
+2. Click the 'PINs' navigation tab.
+
+3. Click 'Add Scratch Card Batch' and select 'Hostel Application' from the prefix pull-down menu, then click create. A csv file will be automatically generated and copied to the WebDAV srp-import folder at https://dav.waeup.org. Please look at the time of creation which is part of the file name. Probably several testers also created test batches already.
+
+4. Go to the PINs Section again and click the respective 'Pin Batch HOS BatchNo #' link of the batch which you just added. Then you can see all unused PIN's. This feature is only available during the testing period. Than it will be replaced by a function which allows to list used PINs together with some information about their usage.
+
+5. Print this list or write down some PINs.
+
+6. Click on the 'Students' navigation tab.
+
+7. You can leave all fields as they are and directly click the search button. You'll see a list of students which we imported from the UME JAMB list sent recently.
+
+8. Print this list or write down some JAMB registration numbers (third column).
+
+9. Log out.
+
+10. Click 'Apply for PUME'.
+
+11. Enter a JAMB registration number and a fresh Application PIN from your printouts. The PIN has to be split into the batch number and the 10-digit random number.
+
+12. A member record has been created and you are logged in (see name in the top left corner). The Registration Status Box shows that you are in the state application_pin_entered (title: 'Admission started'). You can already browse the Academic Section which is called 'Prospectus' for the students. Notice that the colour of the portal has changed: 
+
+::
+
+ gold -> you are logged in as student 
+ grey -> you are logged in as staff member
+
+13. Upload your passport picture from your local computer. You can repeat this as often as you like as long as you have not applied for admission. The picture will be automatically resized. This function is not yet available. It will be implemented in the next SRP version.
+
+14. Click the 'Apply' button.
+
+15. Your status changed from application_pin_entered to admission_applied (Title: 'Admission requested', see Registration Status Box) and your application record is shown (only those fields which are relevant for the students concern).
+
+16. Click on 'Application Slip' and print the slip (Ctrl P).
+
+17. Log out.
+
+18. Click 'Student Login'.
+
+19. Enter your Student Id and the last 10 digits of the Application PIN. Then you'll be logged in again.
+
+20. Log out.
+
+21. Click 'Staff Login' and enter your manager user name and password.
+
+22. Go to the Students Section and select 'applied for admission' from the pull-down menu. Click the Search button.
+
+23. You'll see a list of students which have applied for admission. Your student should be among them.
+
+24. Click on the Student Id and then 'Application Data'.
+
+25. Now you see the entire Application Data record which has been imported from JAMB. The workflow status is 'closed' (see 'Status' on the right-hand side). The PUME results will be filled during import of the PUME result lists.
+
+26. Click 'Up one level' and then 'Personal Data'
+
+27. The Personal Data contain only the name (split into first-, middle- and lastname) and the sex of the student. Both fields were taken from the JAMB record during import. The Personal Data object will be edited by the student after clearance is finished. Only the manager is able to edit all fields right now (see Edit link).
+
+28. Finished 
Index: WAeUP_Doc/OldDocumentation/InstructionsPart4.txt
===================================================================
--- WAeUP_Doc/OldDocumentation/InstructionsPart4.txt	(revision 3212)
+++ WAeUP_Doc/OldDocumentation/InstructionsPart4.txt	(revision 3212)
@@ -0,0 +1,49 @@
+Instructions Part 4 
++++++++++++++++++++
+
+Testing the SRP Application and Accommodation Modules 
++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+1. Open your Firefox browser (IE is not recommended but does also work) and login as manager. You can do that either through the unben-local.waeup.org portal or through the uniben.waeup.org portal. The latter is recommended when opening the website from outside the btedu LAN on campus.
+
+2. Click the 'Hostels' navigation tab.
+
+3. Click 'Add Hall'.
+
+4. Fill all fields. Fields marked with a red star are required. Hold CTRL and click to select multiple beds. Do not click bed letters which are not available. The bed letters must correspond with the number of 'Beds per Room'.
+
+5. Click 'Create' and a new Hall object will be created. 
+
+6. To create a new university-wide bed list or to update an existing one, go to the Accommodation Section (Up one level) and click 'Update Bed List'. Within one second the bed list for the entire accommodation section is created/updated and a bed statistics shows up. In the first part of the statistics you'll see how many new beds have been created. In the second part you can see the total number of beds and the number of booked beds in all halls. If you want to see the bed statistics of a particular hall, click the respective link and you'll get the same information only for this hall. Moreover, you'll see the list of students staying in this hall. Clicking on the student's Id will directly bring you to the respective student's record.
+
+ **Important:** Existing beds in the bed list will never be changed! If you modify the hall specifications, beds will only be added **not** deleted or rededicated. To delete beds (e.g. you want to reduce the number of beds per room) you have to delete the entire hall. Then all beds will be removed and the booking information is lost. 
+
+7. Click the 'PINs' navigation tab.
+
+8. Click 'Add Scratch Card Batch' and select 'Hostel Application' from the prefix pull-down menu, then click create. A csv file with prefix HOS will be automatically generated and copied to the WebDAV srp-import folder at https://dav.waeup.org. Please look at the time of creation which is part of the file name. Probably several testers also created test batches already.
+
+9. Go to the PIN Batches again and click the respective 'Pin Batch HOS BatchNo #' link of the batch which you just added. Then you can see a list of unused PINs and a list of used PIN's together with the Id or JAMB registration numbers of the students who used the PINs. The links will bring you directly to the students' records. The list of unused PINs is only available during the testing period. 
+
+10. Print this list or write down some PINs. Print also the already existing APP PIN list which you need in step 12 to apply for PUME.
+
+11. Log out (and close all browser windows if you have opened more than one).
+
+12. Apply for PUME following steps 10-15 of the Instructions Part 3. 
+
+ **New features:**  (a) Your passport picture will be automatically resized on the server by Python imaging software. At the moment, passport resizing does not work from the Uniben server because the necessary software is not yet installed. (b) The registration status box provides links to the respective registration stages. (c) The 'My Study' tab in the navigation bar shows a list of registration objects. Please look at this list before you apply. You'll see an [edit] link which brings you back to the passport upload form. 
+
+13. Click 'My Accommodation' tab in the student's navigation bar, enter a Hostal Application PIN (HOS PIN) from the list printed before and click 'Book'.
+
+14. Your bed has been booked, your 'Accommodation Record' is shown and you are requested to enter the Maintenance Fee PIN. 
+
+15. Click on 'Accommodation Slip'. The combined 'Hostel Allocation Slip (and Maintenance Receipt)' will show up in an external window. It shows the application data together with your passport picture and the hostel application data record. The Maintenance Fee entries are still empty.
+
+16. Enter the the Maintenance Fee PIN. The PIN prefix depends on the hall where a bed has been booked for you. The instructions on the current page show the code (prefix) and price of the respective Maintenance Fee scratch card. After pressing the 'Save' button your Accommodation object will be closed and your entire Accommodation Record schows up.
+
+17. Click on 'Accommodation Slip' again. The Accommodation Slip now gives also evidence that you have paid the Maintenance Fee. 
+
+18. Log out, close all windows and log in as manager again. Click 'Staff Login' and enter your manager user name and password. 
+
+19. Click on 'Hostels' and then on the name of the hostel where you just booked the room. Your student should be listed at the end of the table. 
+
+20. Finished
Index: WAeUP_Doc/OldDocumentation/InstructionsPart5.txt
===================================================================
--- WAeUP_Doc/OldDocumentation/InstructionsPart5.txt	(revision 3212)
+++ WAeUP_Doc/OldDocumentation/InstructionsPart5.txt	(revision 3212)
@@ -0,0 +1,44 @@
+Instructions Part 5 
++++++++++++++++++++
+
+(See also the Student Manual.)
+
+Testing the SRP PUME Result and Admission Checking Module
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+1. Open your Firefox browser (IE is not recommended but does also work) and login as manager.
+
+2. Click the 'Students' navigation tab.
+
+3. Search for students which are in state 'admitted'. Print or write down some JAMB Reg Numbers. Do the same for state 'admission rejected'.
+
+4. Click the 'PINs' navigation tab and select one of the APP Batches. Print or write down some unused APP PINs.
+
+5. Log out (and close all browser windows if you have opened more than one).
+
+6. Click 'View PUME Results' and enter any valid JAMB Reg Numbers. The PUME Results of that person shows up. 
+
+7. Click on 'PUME Result Slip' to see a printable version.
+
+8. Click 'Check Admission', enter a JAMB Reg Number of any admitted student together with one of the unused APP PINs. Then hit the check button. The student will be logged in and the admission status shows up together with the study course the student is admitted.
+
+9. The student has two options: 
+
+  (a) to accept the proposed study course and to proceed to the clearance form (button 'Continue')
+ 
+  (b) to deny the proposed study course and to raise an objection (button 'Raise an Objection')
+
+  If the student hits the 'Raise an Objection' button, his/her workflow state changes to 'objection_raised'. A message form will show up where the student can communicate the reason for the objection. The registration status changes from 'admitted' to 'objection_raised'. If the students changes his/her mind, he/she can always continue with the clearance process unless the deadline is not exceeded. The transition from 'objection_raised' back to 'admitted' is not possible.
+
+Testing the SRP Frontend Clearance Module
++++++++++++++++++++++++++++++++++++++++++
+
+10. Press the 'Continue' button. You'll be directed to the application form to upload your passport picture. This intermediate step became necessary because we skipped the PUME application procedure.
+
+11. Choose a passport picture from your local hard disk and enter a valid email address, then press 'Save and Return Later' or 'Save and Apply'. The latter brings you directly to the clearance PIN form.
+
+12. Enter a fresh CLR PIN. The clearance form shows up. There are no required field, which means that the 'Save & Return later' button can be pressed even if the form is not completely filled. The 'Save & Submit' button closes the form and sends the data to the Clearance Officer provided that the Acknowledgement Check Box has been ticked. Otherwise, an error message shows up.
+
+13. Click the 'Clearance/Eligibilty Slip' to see a printable version which also includes the application data and your passport picture. This web page is the official document which gives evidence that you have requested clearance. 
+
+14. Click the 'My Study' navigation tab. You'll see all objects which are in the state 'opened', 'closed' or 'public'. Opened objects can be edited by the student. Usually only one object is 'opened' depending on the student's workflow state.  You can either click on the corresponding [edit] link or on the green status link in the student's workflow status box on the left-hand side.
Index: WAeUP_Doc/OldDocumentation/InstructionsPart6.txt
===================================================================
--- WAeUP_Doc/OldDocumentation/InstructionsPart6.txt	(revision 3212)
+++ WAeUP_Doc/OldDocumentation/InstructionsPart6.txt	(revision 3212)
@@ -0,0 +1,11 @@
+Instructions Part 6 
++++++++++++++++++++
+
+Contact Forms
++++++++++++++
+
+1. Only authenticated members can send emails.
+
+2. Emails will be sent to the Administrator's Email Address which can be configured in 'Portal Configuration'.
+
+3. The student's contact form is already prefilled with data. The students can change their preset name and email address but not their Student ID which is always sent so that the sender can always be identified.
Index: WAeUP_Doc/OldDocumentation/InstructionsPart7.txt
===================================================================
--- WAeUP_Doc/OldDocumentation/InstructionsPart7.txt	(revision 3212)
+++ WAeUP_Doc/OldDocumentation/InstructionsPart7.txt	(revision 3212)
@@ -0,0 +1,46 @@
+Instructions Part 7 
++++++++++++++++++++
+
+(See also the Clearance Officer Manual, not yet ready)
+
+
+Testing the SRP Backend Clearance Module
++++++++++++++++++++++++++++++++++++++++++
+
+Requirement: Following the Instructions Part 5, at leat one student must have requested clearance. 
+
+1. Click "Staff Login" and enter your manager user name and password.
+
+2. Go to "Portal Members"
+
+3. Click "Create" in the object action bar.
+
+4. Fill the details of a designated clearance officer. Do not tick the "Manager" check box but highlight the group "ClearanceOfficers".
+
+5. Press the "Create" button.
+
+6. Go to one of the faculties or departments in the Academic Section where the students have applied for admission.
+
+7. Click "Delegate" in the object action bar.
+
+8. Search for the user name of your clearance officer.
+
+9. Select the local role 'ClearanceOfficer' from the pull-down menu and assign. A new box 'Users local roles assignment' will show up, displaying the new role. This assignment process takes a while when delegating the role for an entire faculty, because the system has to change the security settings of all subobjects.
+
+10. Log out.
+
+11. Login with the user name and password of your clearance officer.
+
+12. Go to the Student Section ("Students" tab).
+
+13. A form is shown where you can search for students in the states 'clearance_pin_entered', 'clearance_requested' and 'cleared_and_validated'. Search for students in state 'clearance_requested'. 
+
+14. Only those students will be listed which applied for admission to departments the ClearanceOfficer role has been assigned.
+
+15. Click on the 'clearance_requested' link of one of the students listed. The Clearance Record of this student will be displayed. The clearance officer is not allowed to edit these data but can change the registration state to cleared_and_validated by pressing the button "Validate and Clear" or to 'clearance_pin_entered' by pressing "Reject Clearance" at the end of the page.
+
+16. Press the "Validate and Clear" button. The student's registration status changes to 'cleared_and_validated'.
+
+17. If the clearance officer wants to revise the clearance decision, he/she can still press "Reject Clearance" which resets the state to 'clearance_pin_entered'. 
+
+18. Press "Reject Clearance". A pre-filled email form will be opend to send a message to the student which explains the reasons for rejection. The student can correct the errors and re-submit the form by clicking "Save & Submit".
Index: WAeUP_Doc/OldDocumentation/MainProcesses.rst
===================================================================
--- WAeUP_Doc/OldDocumentation/MainProcesses.rst	(revision 3212)
+++ WAeUP_Doc/OldDocumentation/MainProcesses.rst	(revision 3212)
@@ -0,0 +1,434 @@
+=============================
+Description of Main Processes
+=============================
+
+
+I JAMB UME Entry
+----------------
+
+Students apply for studying at a University of their choice to the Joint Admissions and Matriculation Board (JAMB). JAMB conducts the Universities Matriculation Examination (UME) and sends the results of the students, who have passed the UME, in electronic form (file on CD) directly to the universities. Students check their results online on the JAMB website. Students who have passed the UME can then apply online for the Post University Matriculation Examination (PUME) conducted by Uniben directly on the PUME Application website.
+
+Relevant fields that will be extracted from the JAMB data for further processing are:
+
+::
+
+ Registration Number 
+ Last Name 
+ Surname 
+ Other Names 
+ State of Origin 
+ LGA (Local Government Area) 
+ Date of Birth 
+ Age 
+ Sex 
+ 1st Choice Course of Study 
+ 2nd Choice Course of Study 
+ 1st Choice University 
+ 2nd Choice University 
+ JAMB Score
+
+The extraction is done manually. The Portal Manager uploads and imports the data.
+
+
+Step 1 (online): PUME Application
++++++++++++++++++++++++++++++++++
+
+The student buys an **Application Access Card** and enters the Access Code (PIN) together with his/her JAMB registration number on the *PUME Application Website*. His/Her JAMB data set (see above) will show up and the student will be requested to upload a passport picture. After uploading the picture the student can print out the *PUME Acknowledgement Slip*  for presentation in the examination hall. The picture must be displayed on the Acknowledgement Slip as well as the Admission and Hostel Allocation Slip (see below). Furthermore, a member account with Application PIN (or random) password will be assigned. The password is also displayed on the *PUME Acknowledgement Slip*.
+
+Data fields to be shown on the PUME Acknowledgement Slip: 
+
+::
+ 
+ JAMB Registration Number
+ Student's Name
+ Study Programme/Course (Certificate)
+ Sex
+ PUME Application Date 
+ PUME Exam Date 
+ PUME Venue 
+ Password
+
+- `PUMEAcknowledgementSlip.jpg <Examples/PUMEAcknowledgementSlip.jpg>`_
+
+Other fields to be added to the student's record will include:
+
+::
+
+ Passport Photograph with red background (has to be uploaded here)
+
+ PUME General Paper (relevant after the PUME Exams) 
+ PUME English Score (relevant after the PUME Exams) 
+ PUME Mathematics Score (relevant after the PUME Exams and 
+                         applicable only to Local Programme Students)
+ PUME Total Score (relevant after the PUME Exams) 
+
+
+
+Step 2 (offline): PUME
+++++++++++++++++++++++
+
+The student goes to the examination hall and writes the examination.
+
+
+Step 3 (offline/online): Upload of PUME Results
++++++++++++++++++++++++++++++++++++++++++++++++
+
+The examination officer compiles exam results into an Excel spreadsheet. The Portal Manager uploads and imports the data.
+
+Data fields to be imported: 
+
+::
+
+ PUME General Paper
+ PUME English Score 
+ PUME Mathematics Score (applicable only to Local Programme Students)
+
+
+Step 4 (online): PUME Result Checking
++++++++++++++++++++++++++++++++++++++
+
+The student checks the exam results on the *PUME Results Checking Website*. To access the website he/she reuses his/her **Application PIN** and enters the password (printed on the *PUME Acknowledgement Slip*). He/She will see the results and can print out the *PUME Result Slip*.
+
+Except the password, the PUME Results Checking Website shows the same data as the PUME Acknowledgement Slip. Additionally the PUME results are displayed: English, Mathematics and General (papers 1, 2 and 3 respectively) 
+ 
+
+Step 5 (offline/online): Upload of Admission List
++++++++++++++++++++++++++++++++++++++++++++++++++
+
+The Admission Board decides on those students to be admitted and compiles the Admission List which is then uploaded and imported by the Portal Manager.
+
+- `Admission_upload_excerpt.xls <Examples/Admission_upload_excerpt.xls>`_
+
+Step 6 (online/offline): Admission Checking
++++++++++++++++++++++++++++++++++++++++++++
+
+The student checks for admission to the university on the *Admission Checking Website* and prints out the *Admission Slip*. To enter the website he reuses his **Application PIN** together with the password. He/she will also see the study programme (certificate) he/she is admitted to. This can differ from the student's choice and has to be officially accepted by the student by signing a letter of acceptance to be presented later to the Clearance Officer (formerly done by filling the online Acceptance Form which is now deprecated).
+
+- `AdmissionSlip.html <Examples/AdmissionSlip.html>`_
+
+Step 7 (online): Clearance
+++++++++++++++++++++++++++
+
+The student buys a **Clearance Access Card** and proceeds to the *Clearance and Eligibility Form* where he/she enters the corresponding PIN  and the password first. 
+
+The Eligibility Form contains the following data:
+
+::
+
+ Entry Date 
+ Access Code
+ Session
+ Registration No
+ Student's Name
+ Sex
+ Faculty
+ Course Major
+ Passport Picture
+
+The data are not editable and are taken from the students record compiled so far.
+
+The student has to fill the following fields:
+
+::
+
+ Date of Birth
+ Local Government
+ Nationality
+ 1st Sitting (SSCE, WAEC, GCE, NECO, NABTEB): Exam Number, Exam Date, Exam Type, Exam Subjects, Exam Grades
+ 2nd Sitting (SSCE, WAEC, GCE, NECO, NABTEB): Exam Number, Exam Date, Exam Type, Exam Subjects, Exam Grades
+ Advanced Level Results: Exam Number, Exam Date, Exam Subjects, Exam Grades
+ Other Qualifications: Higher Qualification, Higher Grade, School Attended, Matric Number, Session Obtained, Discipline
+ 
+The relationship between Higher Qualification and Higher Grade is:
+
+::
+
+ Bachelor Degree:
+  First Class
+  Second Class (Upper Division)
+  Second Class (Lower Division)
+  Third Class
+  Pass
+
+ Higher National Diploma:
+  Distinction
+  Upper Credit
+  Lower Credit 
+  Pass
+
+ Ordinary National Diploma:
+  Distinction
+  Upper Credit
+  Lower Credit 
+  Pass
+
+ National Certificate of Education:
+  Distinction
+  Credit 
+  Merit
+  Pass
+
+ University Diploma:
+  Distinction
+  Credit 
+  Merit
+  Pass
+
+
+
+The student has to upload scanned documents which show the results of all examinations done before.
+
+A Local Programme student already entered his/her results of previous examinations in his/her Local Programme Application Form (see Step 1). These data must be carried over into Clearance Form. In contrast to a PUME applicant, the result data are not editable by the student in the Clearance Form. 
+
+Then he/she has to tick appropriate documents to be presented for clearance process. 
+
+Furthermore the student can defer admission till next session by ticking an appropriate box. Finally, the student has to confirm possessing all the qualifications which he/she claims to have obtained. 
+
+- `ClearanceForm.html <Examples/ClearanceForm.html>`_
+
+Step 8 (offline/online): Clearance Validation
++++++++++++++++++++++++++++++++++++++++++++++
+
+The student goes with all documents to the Clearance Officer who validates the entered data and uploaded files. Finally the *Eligibility Form* is printed and signed by both the student and the Course Manager. 
+
+The student is now properly admitted to the university and is a member of the portal.
+
+Step 9 : Matriculation Number Generation
+++++++++++++++++++++++++++++++++++++++++
+
+The Matriculation Number is generated by the system.
+
+- `MatricNumberExplanation.doc <Examples/MatricNumberExplanation.doc>`_
+
+Step 10 (online): Personal Data
++++++++++++++++++++++++++++++++
+
+The student has to fill the *Personal Data Form* which contains all sorts of personal information. Now he/she is also able to change the password for accessing his/her personal portal member area which has been automatically created after Clearance Validation. The basis for Personal Data Form is the data already gathered from the Clearance and Eligibility data. Other details such as permanent home address, next of kin, sponsor and all other such related information are filled in here. The information does not have direct relevance to course registration, but are useful for generation of School identity cards.
+
+- `PersonalData.html <Examples/PersonalData.html>`_
+
+Step 11 (online): Hostel Allocation
++++++++++++++++++++++++++++++++++++
+
+The student buys a **Hostel Application Access Card** and proceeds to the *Hostel Application Form* where he/she enters the PIN. The systems determines if there is free bed space according to the students attributes: sex, study programme, study level, special needs. Beds are allocated according to the 'first come, first serve' principle. The bed allocation algorithm is shown in a separate flow chart.
+
+The student prints the *Hostel Allocation Slip*.
+
+- `HostelAllocationSlip.jpg <Examples/HostelAllocationSlip.jpg>`_
+
+Additionally, this form must also display the passport picture from the student's record. 
+
+
+Step 12 (online): Hostel Maintenance
+++++++++++++++++++++++++++++++++++++
+
+The student buys a **Hostel Maintenance Card** which belongs to the allocated hostel and pays his/her Hostel Fee by entering the PIN on the *Hostel Maintenance Website*.
+
+The student prints the *Hostel Maintenance Receipt*.
+
+- `HostelMaintenanceReceipt.jpg <Examples/HostelMaintenanceReceipt.jpg>`_
+
+
+Step 13 (online): Course Registration
++++++++++++++++++++++++++++++++++++++
+
+The student buys a **School Fee Card** which belongs to his/her study programme or faculty respectively. After entering the PIN on the *Course Registration Form*, the student is able to add (or delete) courses from a list of courses which are automatically generated by the portal according to the student's study programme and level. The total credit load must not exceed 50 units. Otherwise the student is requested to reduce the load.  
+
+The student prints the *School Fees Receipt*.
+
+- `RegistrationForm.jpg <Examples/RegistrationForm.jpg>`_
+- `SchoolFeesReceipt.jpg <Examples/SchoolFeesReceipt.jpg>`_
+
+
+Step 14 (online): Course Adviser Validation
++++++++++++++++++++++++++++++++++++++++++++
+
+The Course Adviser controls and validates the registered courses. This step can be omitted if the course registration process runs completely automatically.
+
+II Returning Students
+---------------------
+
+Returning Students proceed with the above described admission and registration process at Step 11 (Hostel Allocation). They log in with their Matriculation Number and their Password (Step R1). Before they can apply for accommodation or register new courses their previous session result must have been uploaded online by the Portal Manager (Step R2). Only Categories A (passed all courses) and B (passed some but have some carryovers) are eligible to register for a new level in the new session and also to apply for accommodation. The students placed in Category C are students that have just enough credits to remain in the faculty and repeat the level (probation). They are allowed to register for the same level but not to apply for accommodation. The students placed in Category D or higher are either expected to withdraw from the university or been allowed to probate after consulting respective authorities. The latter requires portal manager validation. 
+
+Exception: 200 level Medical students represent a unique group of students who do not write sessional examinations and will thus be allowed to apply for accommodation when they have successfully registered for level 300.  That inadvertently means they have to be allowed to register for 300 level without results for their 200 level.
+
+The students print out the *Sessional Result Slip*. A Student is not allowed to see his scores but rather the grade and Sessional GPA.  The Result Slip however also shows the student's name, matric number, registration number, course of study, faculty, session and level. 
+
+- `CourseResultList.html <Examples/CourseResultList.html>`_
+- `ResultSlip.jpg <Examples/ResultSlip.jpg>`_
+- `GPACalculation.doc <Examples/GPACalculation.doc>`_
+
+Steps 11 - 13 are then identical. Only during course registration the so-called 'carryovers', i.e. the courses that were failed in the previous session, are picked up by the system and listed first.
+
+
+III Direct Entry
+----------------
+
+Direct Entry (DE) Students bypass Step 1 - 4. The Excel Data sheet from JAMB is directly sent to the Admission board. The following procedure is identical as the one for the UME Students.
+
+IV Local Programme Entry
+------------------------
+
+For admission into Diploma (full and part time), Degree (part time) and Post graduate programmes (full and part time) students can bypass the JAMB admission procedure and apply directly at the university. Only the entry examination (Step 2) then differs and is called *Local Programme Examination*. The Local Programme Application Form can be combined with the PUME Application Form (Step 1). However, the application for this requires their results to be added; scanned unlike Post UME where the result is scanned and added after the student has been admitted. If the results are not yet available the students can tick a box called 'awaiting results'. 
+
+Also the 'JAMB data' have to be filled manually. The registration number is generated internally with the pattern of 3-alphabets representing the study programme,  6 digits random number and 2-digits representing the year.
+ 
+For example: ``DIA000001/06`` means the first person to log in is for Diploma in Accounting and is applying in the 2006/2007 session.
+
+
+V Portal Setup
+--------------
+
+(description of portal content types will follow)
+
+
+VI Gown Hiring
+--------------
+
+(forthcoming)
+
+
+VII Access Card Management
+--------------------------
+
+The Access Card (Scratch Card) data are kept outside of the main portal and managed only by the Access Card Manager. 
+
+The data fields of Access Card records are:
+
+::
+
+ Series Batch Code
+ Access Code
+ Matric or Registration Number
+ Cost
+ Generated By
+ Date Activated
+ Sold by
+ 
+
+Each Access Code starts with a prefix depending on the Access Card's function, i.e. what it is used for. The prefix also defines the value of the Access Card.
+
+Administrative PINs:
+
+::
+
+ Application                       APP
+ Clearance                         CLR
+ Hostel Application                HOS
+ Hostel Maintenance 
+  Old Hostels (Halls 1, 2, 3, 4)   HMU
+  New Hostel (Hall 5)              HMF
+  Postgraduate Hostel              HMP
+ Gown Hiring                       GWN
+
+
+School Fee PINs:
+
+::
+
+ AGRICULTURE                       AGR
+ ARTS                              ART
+ BASIC MEDICAL SC.                 BMS
+ DENTISTRY                         DEN
+ EDUCATION                         EDU    
+ ENGINEERING                       ENG
+ LAW                               LAW
+ LIFE SCIENCE                      LSC
+ PHYSICAL                          PSC
+ PHARMACY                          PHA
+ MEDICINE                          MED
+ SOCIAL SCIENCES                   SSC
+
+ Masters in Bus. Admin.            MBA
+ Masters in Public Admin           MPA
+ Masters Banking & Fin.            MBF
+ Masters in Law                    LLM
+ Masters in Public Health          MPH               
+ Bachelors in Public Adm           BPA
+ Bachelors in Accounting           BIA
+ Bachelors in Social Wks           BSW
+ Diploma in Public Adm             DPA
+ Diploma in Law                    DIL
+ Diploma in Data Proc.             DDP
+ Diploma in Comp. Eng              DCE
+
+
+For New Students ``NEW`` is added to the School Fee PIN prefixes. For example, a new student in the Education Faculty will need to buy a Scratch Card with Prefix: ``EDUNEW``. 
+
+The following information will be printed on the Scratch Card:
+
+1. Series Batch Code: Prefix, Batch Number and Serial Number (6 digits).
+2. Access Code (PIN): Prefix, Batch Number and Random Number (10 digits)
+
+::
+
+ XXX-1-12345678
+ XXX-1-1234567890 (conceiled)
+
+
+VIII Portal Roles
+-----------------
+
+Portal Manager (PM)
++++++++++++++++++++
+ 
+The Portal Manager is the main system administrator (or Zope manager) who has exclusive rights to access all parts of the portal including the Zope Management Interface (ZMI). 
+
+University Manager (UM)
++++++++++++++++++++++++
+
+The University Manager is able to set up the infrastructure of the entire university and to provide content specific to the university. 
+
+Student Manager (SM)
+++++++++++++++++++++
+
+The Student Manager is able to access and edit student records. 
+
+Clearance Officer (CO)
+++++++++++++++++++++++
+ 
+The Clearance Officer has access to the eligibility data of all students. His only function is to validate the clearance and eligibility data on the basis of the material presented by each student.
+
+Matric Number Manager (MM)
+++++++++++++++++++++++++++
+
+Only the Matric Number Manager is allowed to edit Matriculation Numbers and to access and configure the Matric Number Generation tool. 
+
+Access Card Manager (AM)
+++++++++++++++++++++++++
+
+The only function of the Access Card Manager will be to generate and administer the Access Codes (PINs).
+
+Faculty Manager (FM)
+++++++++++++++++++++
+
+The Faculty Manager sets up the infrastructure of his/her faculty and provides content specific to his/her faculty. He/She can add or change departments and can assign local roles within all departments.
+
+Department Manager (DM)
++++++++++++++++++++++++
+
+The Department Manager is the supervisor of the Course Adviser und the Lecturers. The DM will manage the content provided by the department (staff list, publication lists, etc). He/She can assign local roles (CA and L) within his/her department. At the current stage the local DM role is not needed.
+
+Course Adviser (CA)
++++++++++++++++++++
+
+The Course Adviser is responsible for the study programmes of the department. He/She selects the courses (from the entire university course list) for each study programme and validates the registered courses of each student who is studying in the department. The CA role is a sub-role of the Department Manager.
+
+Lecturer (L)
+++++++++++++
+
+The Lecturer will be responsible for the courses and course material provided to the students. At the current stage this local role is not needed. 
+
+Hostel Manager (HM)
++++++++++++++++++++
+
+The Hostel Manager sets up and manages the infrastructure of all hostels. 
+
+
+IX Portal Versioning and Archiving
+----------------------------------
+
+Course specific data (including list of participants) are under version control. Each session new course objects are created on the basis of the data of the previous session.
+
+
+
Index: WAeUP_Doc/OldDocumentation/OldDocuJoachim/functionaldescriptions.html
===================================================================
--- WAeUP_Doc/OldDocumentation/OldDocuJoachim/functionaldescriptions.html	(revision 3212)
+++ WAeUP_Doc/OldDocumentation/OldDocuJoachim/functionaldescriptions.html	(revision 3212)
@@ -0,0 +1,469 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
+<title>Functionaldescriptions</title>
+<style type="text/css">
+
+/*
+:Author: David Goodger
+:Contact: goodger@users.sourceforge.net
+:Date: $Date$
+:Revision: $Revision$
+:Copyright: This stylesheet has been placed in the public domain.
+
+Default cascading style sheet for the HTML output of Docutils.
+
+See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to
+customize this style sheet.
+*/
+
+/* used to remove borders from tables and images */
+.borderless, table.borderless td, table.borderless th {
+  border: 0 }
+
+table.borderless td, table.borderless th {
+  /* Override padding for "table.docutils td" with "! important".
+     The right padding separates the table cells. */
+  padding: 0 0.5em 0 0 ! important }
+
+.first {
+  /* Override more specific margin styles with "! important". */
+  margin-top: 0 ! important }
+
+.last, .with-subtitle {
+  margin-bottom: 0 ! important }
+
+.hidden {
+  display: none }
+
+a.toc-backref {
+  text-decoration: none ;
+  color: black }
+
+blockquote.epigraph {
+  margin: 2em 5em ; }
+
+dl.docutils dd {
+  margin-bottom: 0.5em }
+
+/* Uncomment (and remove this text!) to get bold-faced definition list terms
+dl.docutils dt {
+  font-weight: bold }
+*/
+
+div.abstract {
+  margin: 2em 5em }
+
+div.abstract p.topic-title {
+  font-weight: bold ;
+  text-align: center }
+
+div.admonition, div.attention, div.caution, div.danger, div.error,
+div.hint, div.important, div.note, div.tip, div.warning {
+  margin: 2em ;
+  border: medium outset ;
+  padding: 1em }
+
+div.admonition p.admonition-title, div.hint p.admonition-title,
+div.important p.admonition-title, div.note p.admonition-title,
+div.tip p.admonition-title {
+  font-weight: bold ;
+  font-family: sans-serif }
+
+div.attention p.admonition-title, div.caution p.admonition-title,
+div.danger p.admonition-title, div.error p.admonition-title,
+div.warning p.admonition-title {
+  color: red ;
+  font-weight: bold ;
+  font-family: sans-serif }
+
+/* Uncomment (and remove this text!) to get reduced vertical space in
+   compound paragraphs.
+div.compound .compound-first, div.compound .compound-middle {
+  margin-bottom: 0.5em }
+
+div.compound .compound-last, div.compound .compound-middle {
+  margin-top: 0.5em }
+*/
+
+div.dedication {
+  margin: 2em 5em ;
+  text-align: center ;
+  font-style: italic }
+
+div.dedication p.topic-title {
+  font-weight: bold ;
+  font-style: normal }
+
+div.figure {
+  margin-left: 2em ;
+  margin-right: 2em }
+
+div.footer, div.header {
+  clear: both;
+  font-size: smaller }
+
+div.line-block {
+  display: block ;
+  margin-top: 1em ;
+  margin-bottom: 1em }
+
+div.line-block div.line-block {
+  margin-top: 0 ;
+  margin-bottom: 0 ;
+  margin-left: 1.5em }
+
+div.sidebar {
+  margin-left: 1em ;
+  border: medium outset ;
+  padding: 1em ;
+  background-color: #ffffee ;
+  width: 40% ;
+  float: right ;
+  clear: right }
+
+div.sidebar p.rubric {
+  font-family: sans-serif ;
+  font-size: medium }
+
+div.system-messages {
+  margin: 5em }
+
+div.system-messages h1 {
+  color: red }
+
+div.system-message {
+  border: medium outset ;
+  padding: 1em }
+
+div.system-message p.system-message-title {
+  color: red ;
+  font-weight: bold }
+
+div.topic {
+  margin: 2em }
+
+h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
+h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
+  margin-top: 0.4em }
+
+h1.title {
+  text-align: center }
+
+h2.subtitle {
+  text-align: center }
+
+hr.docutils {
+  width: 75% }
+
+img.align-left {
+  clear: left }
+
+img.align-right {
+  clear: right }
+
+ol.simple, ul.simple {
+  margin-bottom: 1em }
+
+ol.arabic {
+  list-style: decimal }
+
+ol.loweralpha {
+  list-style: lower-alpha }
+
+ol.upperalpha {
+  list-style: upper-alpha }
+
+ol.lowerroman {
+  list-style: lower-roman }
+
+ol.upperroman {
+  list-style: upper-roman }
+
+p.attribution {
+  text-align: right ;
+  margin-left: 50% }
+
+p.caption {
+  font-style: italic }
+
+p.credits {
+  font-style: italic ;
+  font-size: smaller }
+
+p.label {
+  white-space: nowrap }
+
+p.rubric {
+  font-weight: bold ;
+  font-size: larger ;
+  color: maroon ;
+  text-align: center }
+
+p.sidebar-title {
+  font-family: sans-serif ;
+  font-weight: bold ;
+  font-size: larger }
+
+p.sidebar-subtitle {
+  font-family: sans-serif ;
+  font-weight: bold }
+
+p.topic-title {
+  font-weight: bold }
+
+pre.address {
+  margin-bottom: 0 ;
+  margin-top: 0 ;
+  font-family: serif ;
+  font-size: 100% }
+
+pre.literal-block, pre.doctest-block {
+  margin-left: 2em ;
+  margin-right: 2em ;
+  background-color: #eeeeee }
+
+span.classifier {
+  font-family: sans-serif ;
+  font-style: oblique }
+
+span.classifier-delimiter {
+  font-family: sans-serif ;
+  font-weight: bold }
+
+span.interpreted {
+  font-family: sans-serif }
+
+span.option {
+  white-space: nowrap }
+
+span.pre {
+  white-space: pre }
+
+span.problematic {
+  color: red }
+
+span.section-subtitle {
+  /* font-size relative to parent (h1..h6 element) */
+  font-size: 80% }
+
+table.citation {
+  border-left: solid 1px gray;
+  margin-left: 1px }
+
+table.docinfo {
+  margin: 2em 4em }
+
+table.docutils {
+  margin-top: 0.5em ;
+  margin-bottom: 0.5em }
+
+table.footnote {
+  border-left: solid 1px black;
+  margin-left: 1px }
+
+table.docutils td, table.docutils th,
+table.docinfo td, table.docinfo th {
+  padding-left: 0.5em ;
+  padding-right: 0.5em ;
+  vertical-align: top }
+
+table.docutils th.field-name, table.docinfo th.docinfo-name {
+  font-weight: bold ;
+  text-align: left ;
+  white-space: nowrap ;
+  padding-left: 0 }
+
+h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
+h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
+  font-size: 100% }
+
+tt.docutils {
+  background-color: #eeeeee }
+
+ul.auto-toc {
+  list-style-type: none }
+
+</style>
+</head>
+<body>
+<div class="document" id="functionaldescriptions">
+<h1 class="title">Functionaldescriptions</h1>
+<h2 class="subtitle" id="accommodation">Accommodation</h2>
+<div class="section">
+<h1><a id="bedkategories" name="bedkategories">Bedkategories</a></h1>
+<ul class="simple">
+<li>female<ul>
+<li>fresh</li>
+<li>returning</li>
+<li>final</li>
+<li>postgraduate</li>
+</ul>
+</li>
+<li>male<ul>
+<li>fresh</li>
+<li>returning</li>
+<li>final</li>
+<li>postgraduate</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section">
+<h1><a id="hostels" name="hostels">Hostels</a></h1>
+<div class="section">
+<h2><a id="hall-one" name="hall-one">Hall One</a></h2>
+<div class="section">
+<h3><a id="structure" name="structure">Structure</a></h3>
+<ul class="simple">
+<li>7 Blocks  (A,B,C,D,E,F,G)<ul>
+<li>3 Floors (100,200,300)<ul>
+<li>10 Rooms<ul>
+<li>6 Bedspaces (A,B,C,D,E,F)</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section">
+<h3><a id="allocation" name="allocation">Allocation</a></h3>
+<ul class="simple">
+<li>Beds A,B female_final</li>
+<li>Beds C   female_returning</li>
+<li>Beds D,E,F female_fresh</li>
+</ul>
+</div>
+</div>
+<div class="section">
+<h2><a id="hall-two" name="hall-two">Hall Two</a></h2>
+<div class="section">
+<h3><a id="id1" name="id1">Structure</a></h3>
+<ul class="simple">
+<li>6 Blocks  (A,B,C,D,E,F)<ul>
+<li>4 Floors (100,200,300,400) ???<ul>
+<li>10 Rooms (1 - 10)<ul>
+<li>8 Bedspaces (A,B,C,D,E,F,G,H)</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section">
+<h3><a id="id2" name="id2">Allocation</a></h3>
+<ul class="simple">
+<li>Beds A,B female_final</li>
+<li>Beds C,D   female_returning</li>
+<li>Beds E,F,G,H female_fresh</li>
+</ul>
+</div>
+</div>
+<div class="section">
+<h2><a id="hall-three" name="hall-three">Hall Three</a></h2>
+<div class="section">
+<h3><a id="id3" name="id3">Structure</a></h3>
+<ul class="simple">
+<li>6 Blocks  (A,B,C,D,E,F)<ul>
+<li>4 Floors (100,200,300,400) ???<ul>
+<li>10 Rooms (1 - 10)<ul>
+<li>8 Bedspaces (A,B,C,D,E,F,G,H)</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section">
+<h3><a id="id4" name="id4">Allocation</a></h3>
+<ul class="simple">
+<li>Beds A,B male_final</li>
+<li>Beds C,D male_returning</li>
+<li>Beds E,F,G,H male_fresh</li>
+</ul>
+</div>
+</div>
+<div class="section">
+<h2><a id="hall-four" name="hall-four">Hall Four</a></h2>
+<div class="section">
+<h3><a id="id5" name="id5">Structure</a></h3>
+<ul class="simple">
+<li>Section I<ul>
+<li>200 Rooms (1 - 200)<ul>
+<li>8 Bedspaces (A,B,C,D,E,F,G,H)</li>
+</ul>
+</li>
+</ul>
+</li>
+<li>Section II<ul>
+<li>200 Rooms (1 - 200)<ul>
+<li>8 Bedspaces (A,B,C,D,E,F,G,H)</li>
+</ul>
+</li>
+</ul>
+</li>
+<li>Section III<ul>
+<li>147 Rooms (1 - 147)<ul>
+<li>8 Bedspaces (A,B,C,D,E,F,G,H)</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section">
+<h3><a id="id6" name="id6">Allocation</a></h3>
+<ul class="simple">
+<li>Beds A,B male_final</li>
+<li>Beds C,D   male_returning</li>
+<li>Beds E,F,G,H male_fresh</li>
+</ul>
+</div>
+</div>
+<div class="section">
+<h2><a id="hall-five" name="hall-five">Hall Five</a></h2>
+<div class="section">
+<h3><a id="id7" name="id7">Structure</a></h3>
+<ul class="simple">
+<li>2 Blocks  (A,B)
+* 100 Bedspaces</li>
+</ul>
+</div>
+<div class="section">
+<h3><a id="id8" name="id8">Allocation</a></h3>
+<ul class="simple">
+<li>Block A female_final</li>
+<li>Block B male_final</li>
+</ul>
+</div>
+</div>
+<div class="section">
+<h2><a id="medical-hostel" name="medical-hostel">Medical Hostel</a></h2>
+<div class="section">
+<h3><a id="id9" name="id9">Structure</a></h3>
+<ul class="simple">
+<li>2 Blocks  (A,B)
+* 138 Bedspaces</li>
+</ul>
+</div>
+<div class="section">
+<h3><a id="id10" name="id10">Allocation</a></h3>
+<ul class="simple">
+<li>Block A female_medical_500_600,female_dental_500_600 (60/40)</li>
+<li>Block B male_medical_500_600,male_dental_500_600 (60/40)</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</body>
+</html>
Index: WAeUP_Doc/OldDocumentation/OldDocuJoachim/functionaldescriptions.txt
===================================================================
--- WAeUP_Doc/OldDocumentation/OldDocuJoachim/functionaldescriptions.txt	(revision 3212)
+++ WAeUP_Doc/OldDocumentation/OldDocuJoachim/functionaldescriptions.txt	(revision 3212)
@@ -0,0 +1,150 @@
+======================
+Functionaldescriptions
+======================
+
+
+Accommodation
+=============
+
+
+Bedkategories
+-------------
+
+- female
+
+  + fresh
+  + returning
+  + final
+  + postgraduate
+
+- male
+
+  + fresh
+  + returning
+  + final
+  + postgraduate
+
+Hostels
+-------------
+
+Hall One
+````````
+Structure
+:::::::::
+
+- 7 Blocks  (A,B,C,D,E,F,G)
+
+  * 3 Floors (100,200,300)
+
+    + 10 Rooms
+
+      - 6 Bedspaces (A,B,C,D,E,F)
+
+Allocation
+::::::::::
+
+- Beds A,B female_final
+- Beds C   female_returning
+- Beds D,E,F female_fresh
+
+Hall Two
+````````
+Structure
+:::::::::
+
+- 6 Blocks  (A,B,C,D,E,F)
+
+  * 4 Floors (100,200,300,400) ???
+  
+    + 10 Rooms (1 - 10)
+    
+      - 8 Bedspaces (A,B,C,D,E,F,G,H)
+
+Allocation
+::::::::::
+
+- Beds A,B female_final
+- Beds C,D   female_returning
+- Beds E,F,G,H female_fresh
+
+Hall Three
+``````````
+Structure
+:::::::::
+
+- 6 Blocks  (A,B,C,D,E,F)
+
+  * 4 Floors (100,200,300,400) ???
+  
+    + 10 Rooms (1 - 10)
+    
+      - 8 Bedspaces (A,B,C,D,E,F,G,H)
+      
+
+Allocation
+::::::::::
+
+- Beds A,B male_final
+- Beds C,D male_returning
+- Beds E,F,G,H male_fresh
+
+Hall Four
+`````````
+Structure
+:::::::::
+
+- Section I
+
+  * 200 Rooms (1 - 200)
+  
+    + 8 Bedspaces (A,B,C,D,E,F,G,H)
+
+- Section II
+
+  * 200 Rooms (1 - 200)
+  
+    + 8 Bedspaces (A,B,C,D,E,F,G,H)
+     
+
+- Section III
+
+  * 147 Rooms (1 - 147)
+
+    + 8 Bedspaces (A,B,C,D,E,F,G,H)
+
+
+Allocation
+::::::::::
+
+- Beds A,B male_final
+- Beds C,D   male_returning
+- Beds E,F,G,H male_fresh
+
+Hall Five
+`````````
+Structure
+:::::::::
+
+- 2 Blocks  (A,B)
+  * 100 Bedspaces
+
+Allocation
+::::::::::
+
+- Block A female_final
+- Block B male_final
+
+Medical Hostel
+``````````````
+Structure
+:::::::::
+
+- 2 Blocks  (A,B)
+  * 138 Bedspaces
+
+Allocation
+::::::::::
+
+- Block A female_medical_500_600,female_dental_500_600 (60/40)
+- Block B male_medical_500_600,male_dental_500_600 (60/40)
+
Index: WAeUP_Doc/OldDocumentation/OldDocuJoachim/usecases.html
===================================================================
--- WAeUP_Doc/OldDocumentation/OldDocuJoachim/usecases.html	(revision 3212)
+++ WAeUP_Doc/OldDocumentation/OldDocuJoachim/usecases.html	(revision 3212)
@@ -0,0 +1,324 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
+<title>Usecases</title>
+<style type="text/css">
+
+/*
+:Author: David Goodger
+:Contact: goodger@users.sourceforge.net
+:Date: $Date$
+:Revision: $Revision$
+:Copyright: This stylesheet has been placed in the public domain.
+
+Default cascading style sheet for the HTML output of Docutils.
+
+See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to
+customize this style sheet.
+*/
+
+/* used to remove borders from tables and images */
+.borderless, table.borderless td, table.borderless th {
+  border: 0 }
+
+table.borderless td, table.borderless th {
+  /* Override padding for "table.docutils td" with "! important".
+     The right padding separates the table cells. */
+  padding: 0 0.5em 0 0 ! important }
+
+.first {
+  /* Override more specific margin styles with "! important". */
+  margin-top: 0 ! important }
+
+.last, .with-subtitle {
+  margin-bottom: 0 ! important }
+
+.hidden {
+  display: none }
+
+a.toc-backref {
+  text-decoration: none ;
+  color: black }
+
+blockquote.epigraph {
+  margin: 2em 5em ; }
+
+dl.docutils dd {
+  margin-bottom: 0.5em }
+
+/* Uncomment (and remove this text!) to get bold-faced definition list terms
+dl.docutils dt {
+  font-weight: bold }
+*/
+
+div.abstract {
+  margin: 2em 5em }
+
+div.abstract p.topic-title {
+  font-weight: bold ;
+  text-align: center }
+
+div.admonition, div.attention, div.caution, div.danger, div.error,
+div.hint, div.important, div.note, div.tip, div.warning {
+  margin: 2em ;
+  border: medium outset ;
+  padding: 1em }
+
+div.admonition p.admonition-title, div.hint p.admonition-title,
+div.important p.admonition-title, div.note p.admonition-title,
+div.tip p.admonition-title {
+  font-weight: bold ;
+  font-family: sans-serif }
+
+div.attention p.admonition-title, div.caution p.admonition-title,
+div.danger p.admonition-title, div.error p.admonition-title,
+div.warning p.admonition-title {
+  color: red ;
+  font-weight: bold ;
+  font-family: sans-serif }
+
+/* Uncomment (and remove this text!) to get reduced vertical space in
+   compound paragraphs.
+div.compound .compound-first, div.compound .compound-middle {
+  margin-bottom: 0.5em }
+
+div.compound .compound-last, div.compound .compound-middle {
+  margin-top: 0.5em }
+*/
+
+div.dedication {
+  margin: 2em 5em ;
+  text-align: center ;
+  font-style: italic }
+
+div.dedication p.topic-title {
+  font-weight: bold ;
+  font-style: normal }
+
+div.figure {
+  margin-left: 2em ;
+  margin-right: 2em }
+
+div.footer, div.header {
+  clear: both;
+  font-size: smaller }
+
+div.line-block {
+  display: block ;
+  margin-top: 1em ;
+  margin-bottom: 1em }
+
+div.line-block div.line-block {
+  margin-top: 0 ;
+  margin-bottom: 0 ;
+  margin-left: 1.5em }
+
+div.sidebar {
+  margin-left: 1em ;
+  border: medium outset ;
+  padding: 1em ;
+  background-color: #ffffee ;
+  width: 40% ;
+  float: right ;
+  clear: right }
+
+div.sidebar p.rubric {
+  font-family: sans-serif ;
+  font-size: medium }
+
+div.system-messages {
+  margin: 5em }
+
+div.system-messages h1 {
+  color: red }
+
+div.system-message {
+  border: medium outset ;
+  padding: 1em }
+
+div.system-message p.system-message-title {
+  color: red ;
+  font-weight: bold }
+
+div.topic {
+  margin: 2em }
+
+h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
+h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
+  margin-top: 0.4em }
+
+h1.title {
+  text-align: center }
+
+h2.subtitle {
+  text-align: center }
+
+hr.docutils {
+  width: 75% }
+
+img.align-left {
+  clear: left }
+
+img.align-right {
+  clear: right }
+
+ol.simple, ul.simple {
+  margin-bottom: 1em }
+
+ol.arabic {
+  list-style: decimal }
+
+ol.loweralpha {
+  list-style: lower-alpha }
+
+ol.upperalpha {
+  list-style: upper-alpha }
+
+ol.lowerroman {
+  list-style: lower-roman }
+
+ol.upperroman {
+  list-style: upper-roman }
+
+p.attribution {
+  text-align: right ;
+  margin-left: 50% }
+
+p.caption {
+  font-style: italic }
+
+p.credits {
+  font-style: italic ;
+  font-size: smaller }
+
+p.label {
+  white-space: nowrap }
+
+p.rubric {
+  font-weight: bold ;
+  font-size: larger ;
+  color: maroon ;
+  text-align: center }
+
+p.sidebar-title {
+  font-family: sans-serif ;
+  font-weight: bold ;
+  font-size: larger }
+
+p.sidebar-subtitle {
+  font-family: sans-serif ;
+  font-weight: bold }
+
+p.topic-title {
+  font-weight: bold }
+
+pre.address {
+  margin-bottom: 0 ;
+  margin-top: 0 ;
+  font-family: serif ;
+  font-size: 100% }
+
+pre.literal-block, pre.doctest-block {
+  margin-left: 2em ;
+  margin-right: 2em ;
+  background-color: #eeeeee }
+
+span.classifier {
+  font-family: sans-serif ;
+  font-style: oblique }
+
+span.classifier-delimiter {
+  font-family: sans-serif ;
+  font-weight: bold }
+
+span.interpreted {
+  font-family: sans-serif }
+
+span.option {
+  white-space: nowrap }
+
+span.pre {
+  white-space: pre }
+
+span.problematic {
+  color: red }
+
+span.section-subtitle {
+  /* font-size relative to parent (h1..h6 element) */
+  font-size: 80% }
+
+table.citation {
+  border-left: solid 1px gray;
+  margin-left: 1px }
+
+table.docinfo {
+  margin: 2em 4em }
+
+table.docutils {
+  margin-top: 0.5em ;
+  margin-bottom: 0.5em }
+
+table.footnote {
+  border-left: solid 1px black;
+  margin-left: 1px }
+
+table.docutils td, table.docutils th,
+table.docinfo td, table.docinfo th {
+  padding-left: 0.5em ;
+  padding-right: 0.5em ;
+  vertical-align: top }
+
+table.docutils th.field-name, table.docinfo th.docinfo-name {
+  font-weight: bold ;
+  text-align: left ;
+  white-space: nowrap ;
+  padding-left: 0 }
+
+h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
+h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
+  font-size: 100% }
+
+tt.docutils {
+  background-color: #eeeeee }
+
+ul.auto-toc {
+  list-style-type: none }
+
+</style>
+</head>
+<body>
+<div class="document" id="usecases">
+<h1 class="title">Usecases</h1>
+<h2 class="subtitle" id="accommodation">Accommodation</h2>
+<div class="section">
+<h1><a id="manager" name="manager">Manager</a></h1>
+<div class="section">
+<h2><a id="assign-bedspace" name="assign-bedspace">Assign Bedspace</a></h2>
+<p>A single bedspace can be assigned to a student according to his/her sex.</p>
+</div>
+<div class="section">
+<h2><a id="deassign-bedspace" name="deassign-bedspace">Deassign Bedspace</a></h2>
+<p>An assigned bedspace can be deassigned</p>
+</div>
+</div>
+<div class="section">
+<h1><a id="student" name="student">Student</a></h1>
+<div class="section">
+<h2><a id="id1" name="id1">Assign Bedspace</a></h2>
+<p>A single bedspace is automatically assigned to a student according to</p>
+<ul class="simple">
+<li>sex</li>
+<li>level of study</li>
+<li>course of study</li>
+</ul>
+<p>if such a bedspace is available.</p>
+<p>This is protected by a N500.00 scratchcard.</p>
+<p>The Hostel Allocation Slip is printed.</p>
+</div>
+</div>
+</div>
+</body>
+</html>
Index: WAeUP_Doc/OldDocumentation/OldDocuJoachim/usecases.txt
===================================================================
--- WAeUP_Doc/OldDocumentation/OldDocuJoachim/usecases.txt	(revision 3212)
+++ WAeUP_Doc/OldDocumentation/OldDocuJoachim/usecases.txt	(revision 3212)
@@ -0,0 +1,35 @@
+========
+Usecases
+========
+
+Accommodation
+=============
+
+Manager
+```````
+Assign Bedspace
+:::::::::::::::
+A single bedspace can be assigned to a student according to his/her sex.
+
+Deassign Bedspace
+:::::::::::::::::
+An assigned bedspace can be deassigned
+
+Student
+```````
+Assign Bedspace
+:::::::::::::::
+A single bedspace is automatically assigned to a student according to
+ 
+- sex
+- level of study
+- course of study
+
+if such a bedspace is available.
+
+This is protected by a N500.00 scratchcard.
+
+The Hostel Allocation Slip is printed.
+
+
+
Index: WAeUP_Doc/OldDocumentation/OldDocuJoachim/userdescriptions.html
===================================================================
--- WAeUP_Doc/OldDocumentation/OldDocuJoachim/userdescriptions.html	(revision 3212)
+++ WAeUP_Doc/OldDocumentation/OldDocuJoachim/userdescriptions.html	(revision 3212)
@@ -0,0 +1,434 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
+<title>Userdescriptions</title>
+<style type="text/css">
+
+/*
+:Author: David Goodger
+:Contact: goodger@users.sourceforge.net
+:Date: $Date$
+:Revision: $Revision$
+:Copyright: This stylesheet has been placed in the public domain.
+
+Default cascading style sheet for the HTML output of Docutils.
+
+See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to
+customize this style sheet.
+*/
+
+/* used to remove borders from tables and images */
+.borderless, table.borderless td, table.borderless th {
+  border: 0 }
+
+table.borderless td, table.borderless th {
+  /* Override padding for "table.docutils td" with "! important".
+     The right padding separates the table cells. */
+  padding: 0 0.5em 0 0 ! important }
+
+.first {
+  /* Override more specific margin styles with "! important". */
+  margin-top: 0 ! important }
+
+.last, .with-subtitle {
+  margin-bottom: 0 ! important }
+
+.hidden {
+  display: none }
+
+a.toc-backref {
+  text-decoration: none ;
+  color: black }
+
+blockquote.epigraph {
+  margin: 2em 5em ; }
+
+dl.docutils dd {
+  margin-bottom: 0.5em }
+
+/* Uncomment (and remove this text!) to get bold-faced definition list terms
+dl.docutils dt {
+  font-weight: bold }
+*/
+
+div.abstract {
+  margin: 2em 5em }
+
+div.abstract p.topic-title {
+  font-weight: bold ;
+  text-align: center }
+
+div.admonition, div.attention, div.caution, div.danger, div.error,
+div.hint, div.important, div.note, div.tip, div.warning {
+  margin: 2em ;
+  border: medium outset ;
+  padding: 1em }
+
+div.admonition p.admonition-title, div.hint p.admonition-title,
+div.important p.admonition-title, div.note p.admonition-title,
+div.tip p.admonition-title {
+  font-weight: bold ;
+  font-family: sans-serif }
+
+div.attention p.admonition-title, div.caution p.admonition-title,
+div.danger p.admonition-title, div.error p.admonition-title,
+div.warning p.admonition-title {
+  color: red ;
+  font-weight: bold ;
+  font-family: sans-serif }
+
+/* Uncomment (and remove this text!) to get reduced vertical space in
+   compound paragraphs.
+div.compound .compound-first, div.compound .compound-middle {
+  margin-bottom: 0.5em }
+
+div.compound .compound-last, div.compound .compound-middle {
+  margin-top: 0.5em }
+*/
+
+div.dedication {
+  margin: 2em 5em ;
+  text-align: center ;
+  font-style: italic }
+
+div.dedication p.topic-title {
+  font-weight: bold ;
+  font-style: normal }
+
+div.figure {
+  margin-left: 2em ;
+  margin-right: 2em }
+
+div.footer, div.header {
+  clear: both;
+  font-size: smaller }
+
+div.line-block {
+  display: block ;
+  margin-top: 1em ;
+  margin-bottom: 1em }
+
+div.line-block div.line-block {
+  margin-top: 0 ;
+  margin-bottom: 0 ;
+  margin-left: 1.5em }
+
+div.sidebar {
+  margin-left: 1em ;
+  border: medium outset ;
+  padding: 1em ;
+  background-color: #ffffee ;
+  width: 40% ;
+  float: right ;
+  clear: right }
+
+div.sidebar p.rubric {
+  font-family: sans-serif ;
+  font-size: medium }
+
+div.system-messages {
+  margin: 5em }
+
+div.system-messages h1 {
+  color: red }
+
+div.system-message {
+  border: medium outset ;
+  padding: 1em }
+
+div.system-message p.system-message-title {
+  color: red ;
+  font-weight: bold }
+
+div.topic {
+  margin: 2em }
+
+h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
+h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
+  margin-top: 0.4em }
+
+h1.title {
+  text-align: center }
+
+h2.subtitle {
+  text-align: center }
+
+hr.docutils {
+  width: 75% }
+
+img.align-left {
+  clear: left }
+
+img.align-right {
+  clear: right }
+
+ol.simple, ul.simple {
+  margin-bottom: 1em }
+
+ol.arabic {
+  list-style: decimal }
+
+ol.loweralpha {
+  list-style: lower-alpha }
+
+ol.upperalpha {
+  list-style: upper-alpha }
+
+ol.lowerroman {
+  list-style: lower-roman }
+
+ol.upperroman {
+  list-style: upper-roman }
+
+p.attribution {
+  text-align: right ;
+  margin-left: 50% }
+
+p.caption {
+  font-style: italic }
+
+p.credits {
+  font-style: italic ;
+  font-size: smaller }
+
+p.label {
+  white-space: nowrap }
+
+p.rubric {
+  font-weight: bold ;
+  font-size: larger ;
+  color: maroon ;
+  text-align: center }
+
+p.sidebar-title {
+  font-family: sans-serif ;
+  font-weight: bold ;
+  font-size: larger }
+
+p.sidebar-subtitle {
+  font-family: sans-serif ;
+  font-weight: bold }
+
+p.topic-title {
+  font-weight: bold }
+
+pre.address {
+  margin-bottom: 0 ;
+  margin-top: 0 ;
+  font-family: serif ;
+  font-size: 100% }
+
+pre.literal-block, pre.doctest-block {
+  margin-left: 2em ;
+  margin-right: 2em ;
+  background-color: #eeeeee }
+
+span.classifier {
+  font-family: sans-serif ;
+  font-style: oblique }
+
+span.classifier-delimiter {
+  font-family: sans-serif ;
+  font-weight: bold }
+
+span.interpreted {
+  font-family: sans-serif }
+
+span.option {
+  white-space: nowrap }
+
+span.pre {
+  white-space: pre }
+
+span.problematic {
+  color: red }
+
+span.section-subtitle {
+  /* font-size relative to parent (h1..h6 element) */
+  font-size: 80% }
+
+table.citation {
+  border-left: solid 1px gray;
+  margin-left: 1px }
+
+table.docinfo {
+  margin: 2em 4em }
+
+table.docutils {
+  margin-top: 0.5em ;
+  margin-bottom: 0.5em }
+
+table.footnote {
+  border-left: solid 1px black;
+  margin-left: 1px }
+
+table.docutils td, table.docutils th,
+table.docinfo td, table.docinfo th {
+  padding-left: 0.5em ;
+  padding-right: 0.5em ;
+  vertical-align: top }
+
+table.docutils th.field-name, table.docinfo th.docinfo-name {
+  font-weight: bold ;
+  text-align: left ;
+  white-space: nowrap ;
+  padding-left: 0 }
+
+h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
+h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
+  font-size: 100% }
+
+tt.docutils {
+  background-color: #eeeeee }
+
+ul.auto-toc {
+  list-style-type: none }
+
+</style>
+</head>
+<body>
+<div class="document" id="userdescriptions">
+<h1 class="title">Userdescriptions</h1>
+<h2 class="subtitle" id="accommodation">Accommodation</h2>
+<div class="section">
+<h1><a id="hostel-allocation-slip" name="hostel-allocation-slip">HOSTEL ALLOCATION SLIP</a></h1>
+<p>The fields needed for generating Hostel Allocation Slip are as follows:</p>
+<dl class="docutils">
+<dt>Student's Entry Registration No.</dt>
+<dd>(for new students, Matriculation No. for Old Students)</dd>
+</dl>
+<p>Full Name</p>
+<dl class="docutils">
+<dt>Access PIN</dt>
+<dd>(the Scratch PIN purchased from a bank and used for the application)</dd>
+<dt>Sex</dt>
+<dd>(eg. Male or Female)</dd>
+<dt>Session</dt>
+<dd>(Current Academic Session</dd>
+<dt>Course of Study</dt>
+<dd>(e.g. Medicine, Pharmacy, Biochemistry, Law or Accounting)</dd>
+<dt>Level of Study</dt>
+<dd>(100, 200, 300, 400, 500 or 600 depending on the course of study)</dd>
+</dl>
+<p>Then the details of the hostel allocation comprising:</p>
+<dl class="docutils">
+<dt>Date of Allocation</dt>
+<dd>(This is the date the reservation was made)</dd>
+</dl>
+<p>Name of Residence Hall</p>
+<p>Block</p>
+<p>Room Number</p>
+<p>Bed Space Allocated</p>
+<dl class="docutils">
+<dt>Annotation/Note</dt>
+<dd>This is to affirm that you have been allocated a room in the hostel,
+details as shown above. Please print this Allocation Slip and keep for Hostel Clearance</dd>
+</dl>
+</div>
+<div class="section">
+<h1><a id="hostel-categories" name="hostel-categories">HOSTEL CATEGORIES</a></h1>
+<p>The Hostel Categories are as follows:</p>
+<ul class="simple">
+<li>Ugbowo Campus (Main Campus)<ol class="arabic">
+<li>Hall One:  For all Categories of Female Students</li>
+<li>Hall Two:  For all Categories of Female Students</li>
+<li>Hall Three: For all Categories of Male Students</li>
+<li>Hall Four: For all Categories of Male Students</li>
+<li>Hall Five: For only Final Year Male &amp; Female Students</li>
+<li>Medical Hostel: For all 500 &amp; 600 Level Medical &amp; Dental Students only</li>
+</ol>
+</li>
+<li>Ekehuan Campus (satellite campus)<ol class="arabic">
+<li>Female Undergraduate Hall</li>
+<li>Male Undergraduate Hall</li>
+<li>Postgraduate Hostel: For all Male Postgraduate Students</li>
+<li>Postgraduate Female Hostel: For all Female Postgraduate Students</li>
+</ol>
+</li>
+</ul>
+</div>
+<div class="section">
+<h1><a id="detailed-hostel-description" name="detailed-hostel-description">DETAILED HOSTEL DESCRIPTION</a></h1>
+<div class="section">
+<h2><a id="hall-one" name="hall-one">Hall One</a></h2>
+<p>Consist of 7 Blocks labeled A,B,C.. &amp; G, each Block consist of 30 rooms
+spread across three floors (10 rooms per floor). The first room on the
+Ground floor of Block A is numbered 101, the next 102, while the last room
+is labeled 110. The first room on the next floor is also labeled 201, next
+202 and the 10th room on that floor is 210. Each room has 6 bed spaces
+labeled A, B, C, D, E &amp; F. Therefore, the first space to be allocated will
+Hall one, Block A, Room 101, Bed Space A.</p>
+<p>Therefore, there are a total of 1,260 bed spaces in Hall One. (7 Blocks X 30
+rooms X 6 bed spaces).</p>
+</div>
+<div class="section">
+<h2><a id="hall-two" name="hall-two">Hall Two</a></h2>
+<p>This hall consist of 6 Blocks labeled A, B,C, D,E &amp; F; each Block consist of
+40 rooms, each room has 8 bed spaces. The bed spaces are labeled exactly as
+described in Hall One above.</p>
+<p>Therefore, there are a total of 1,920 bed spaces in Hall One. (6 Blocks X 40
+rooms  bed spaces).</p>
+</div>
+<div class="section">
+<h2><a id="hall-three" name="hall-three">Hall Three</a></h2>
+<p>Same as Hall Two</p>
+</div>
+<div class="section">
+<h2><a id="hall-four" name="hall-four">Hall Four</a></h2>
+<p>This hall is divided into 3 Sections as follows:</p>
+<dl class="docutils">
+<dt>Section I</dt>
+<dd>has a total of 200 Rooms with 8 bed spaces in each room</dd>
+<dt>Section II</dt>
+<dd>has a total of 200 Rooms with 8 bed spaces in each room</dd>
+<dt>Section III</dt>
+<dd>has a total of 147 Rooms with 8 bed spaces in each room</dd>
+</dl>
+<p>Therefore, there are a total of 4,376 bed spaces in Hall Four.</p>
+</div>
+<div class="section">
+<h2><a id="hall-five" name="hall-five">Hall Five</a></h2>
+<p>This hall of residence has two blocks, each has 100 bed spaces. One block accommodates
+final year male students while the other is for final  year female students.</p>
+</div>
+<div class="section">
+<h2><a id="medical-hostel" name="medical-hostel">Medical Hostel</a></h2>
+<p>Has two blocks, each for male and female (500 &amp; 600 Medical &amp; Dental Students) with capacity  to accommodate 138 students each.</p>
+<p>Postgraduate Accommodation is currently being handled manually, I will give
+the details in my subsequent mail.</p>
+</div>
+</div>
+<div class="section">
+<h1><a id="hostel-allocation-criteria" name="hostel-allocation-criteria">Hostel Allocation Criteria</a></h1>
+<p>1. Only Full Time (Undergraduate &amp; Postgraduate Students are entitled to
+Hostel Accommodation Allocation.</p>
+<p>2. For all undergraduate hostel allocations, the available bed spaces are
+allocated as follows</p>
+<blockquote>
+<ol class="loweralpha simple">
+<li>Bed Spaces A &amp; B in halls one, two, three &amp; four are meant for Final Year Students only</li>
+<li>Bed Space C in Hall One is strictly meant for Returning Students</li>
+<li>Bed Spaces D,E &amp; F in Hall One are meant to be allocated to fresh students</li>
+<li>In Halls Two, Three and Four, Bed Spaces C &amp; D are for Returning Students and E,F,G &amp; H are for Fresh Students</li>
+</ol>
+</blockquote>
+<p>3. Medical Hostel are allocated 500 &amp; 600 Medical and Dental Students at a
+ratio 60:40 respectively</p>
+<p>4. All the available bed spaces (A, B, C, D, E, F, G &amp; H) in Hall Five are
+allocated to FINAL YEAR ONLY</p>
+<p>5. Just before the commencement of Hostel Allocations, some reservations are
+made officially for Student Union Leaders, Sports Men and Women, Disabled or
+Physically-Challenged Students, etc. Therefore, there should be provision to
+make reservations at the back-end, and populate such reservations at a later
+date.</p>
+<p>6. The Hall of Residence attracts different charges, so students do not pay
+same amount for allocated spaces</p>
+<p>7. The Hostel Application Fee is all the same irrespective of the Hall of
+Residence the student is seeking reservation, and it N500.00</p>
+</div>
+</div>
+</body>
+</html>
Index: WAeUP_Doc/OldDocumentation/OldDocuJoachim/userdescriptions.txt
===================================================================
--- WAeUP_Doc/OldDocumentation/OldDocuJoachim/userdescriptions.txt	(revision 3212)
+++ WAeUP_Doc/OldDocumentation/OldDocuJoachim/userdescriptions.txt	(revision 3212)
@@ -0,0 +1,175 @@
+================
+Userdescriptions
+================
+
+
+Accommodation
+=============
+HOSTEL ALLOCATION SLIP
+----------------------
+
+
+The fields needed for generating Hostel Allocation Slip are as follows:
+
+Student's Entry Registration No. 
+  (for new students, Matriculation No. for Old Students)
+
+Full Name
+
+Access PIN 
+  (the Scratch PIN purchased from a bank and used for the application)
+
+Sex
+  (eg. Male or Female)
+	
+Session
+  (Current Academic Session
+	
+Course of Study
+  (e.g. Medicine, Pharmacy, Biochemistry, Law or Accounting)
+  
+Level of Study 
+  (100, 200, 300, 400, 500 or 600 depending on the course of study)
+
+Then the details of the hostel allocation comprising:
+
+Date of Allocation
+  (This is the date the reservation was made)
+
+Name of Residence Hall
+	
+Block 
+
+Room Number
+
+Bed Space Allocated
+
+Annotation/Note
+  This is to affirm that you have been allocated a room in the hostel,
+  details as shown above. Please print this Allocation Slip and keep for Hostel Clearance
+
+
+HOSTEL CATEGORIES
+-----------------
+    
+The Hostel Categories are as follows:
+
+- Ugbowo Campus (Main Campus)
+
+  1. Hall One:  For all Categories of Female Students
+  2. Hall Two:  For all Categories of Female Students
+  3. Hall Three: For all Categories of Male Students
+  4. Hall Four: For all Categories of Male Students
+  5. Hall Five: For only Final Year Male & Female Students
+  6. Medical Hostel: For all 500 & 600 Level Medical & Dental Students only
+ 
+- Ekehuan Campus (satellite campus)
+
+  1. Female Undergraduate Hall 
+  2. Male Undergraduate Hall 
+  3. Postgraduate Hostel: For all Male Postgraduate Students 
+  4. Postgraduate Female Hostel: For all Female Postgraduate Students
+
+
+DETAILED HOSTEL DESCRIPTION
+---------------------------
+
+Hall One
+::::::::
+
+Consist of 7 Blocks labeled A,B,C.. & G, each Block consist of 30 rooms
+spread across three floors (10 rooms per floor). The first room on the
+Ground floor of Block A is numbered 101, the next 102, while the last room
+is labeled 110. The first room on the next floor is also labeled 201, next
+202 and the 10th room on that floor is 210. Each room has 6 bed spaces
+labeled A, B, C, D, E & F. Therefore, the first space to be allocated will
+Hall one, Block A, Room 101, Bed Space A. 
+
+Therefore, there are a total of 1,260 bed spaces in Hall One. (7 Blocks X 30
+rooms X 6 bed spaces).
+
+Hall Two
+::::::::
+ 
+This hall consist of 6 Blocks labeled A, B,C, D,E & F; each Block consist of
+40 rooms, each room has 8 bed spaces. The bed spaces are labeled exactly as
+described in Hall One above.
+
+Therefore, there are a total of 1,920 bed spaces in Hall One. (6 Blocks X 40
+rooms  bed spaces).
+
+
+Hall Three
+::::::::::
+
+Same as Hall Two
+
+Hall Four
+:::::::::
+
+This hall is divided into 3 Sections as follows:
+
+Section I 
+  has a total of 200 Rooms with 8 bed spaces in each room
+
+Section II 
+  has a total of 200 Rooms with 8 bed spaces in each room
+
+Section III
+  has a total of 147 Rooms with 8 bed spaces in each room
+
+Therefore, there are a total of 4,376 bed spaces in Hall Four.
+
+Hall Five
+:::::::::
+
+This hall of residence has two blocks, each has 100 bed spaces. One block accommodates
+final year male students while the other is for final  year female students.
+
+Medical Hostel
+::::::::::::::
+
+Has two blocks, each for male and female (500 & 600 Medical & Dental Students) with capacity  to accommodate 138 students each.
+
+Postgraduate Accommodation is currently being handled manually, I will give
+the details in my subsequent mail.
+
+
+Hostel Allocation Criteria
+--------------------------
+
+1. Only Full Time (Undergraduate & Postgraduate Students are entitled to
+Hostel Accommodation Allocation. 
+
+2. For all undergraduate hostel allocations, the available bed spaces are
+allocated as follows
+
+ a) Bed Spaces A & B in halls one, two, three & four are meant for Final 
+    Year Students only
+
+ b) Bed Space C in Hall One is strictly meant for Returning Students 
+
+ c) Bed Spaces D,E & F in Hall One are meant to be allocated to fresh students
+
+ d) In Halls Two, Three and Four, Bed Spaces C & D are for Returning Students 
+    and E,F,G & H are for Fresh Students
+
+
+3. Medical Hostel are allocated 500 & 600 Medical and Dental Students at a
+ratio 60:40 respectively
+
+4. All the available bed spaces (A, B, C, D, E, F, G & H) in Hall Five are
+allocated to FINAL YEAR ONLY
+
+5. Just before the commencement of Hostel Allocations, some reservations are
+made officially for Student Union Leaders, Sports Men and Women, Disabled or
+Physically-Challenged Students, etc. Therefore, there should be provision to
+make reservations at the back-end, and populate such reservations at a later
+date.
+
+6. The Hall of Residence attracts different charges, so students do not pay
+same amount for allocated spaces
+
+7. The Hostel Application Fee is all the same irrespective of the Hall of
+Residence the student is seeking reservation, and it N500.00
+
