Index: WAeUP_Doc/InstructionsPart1.rst
===================================================================
--- WAeUP_Doc/InstructionsPart1.rst	(revision 1617)
+++ 	(revision )
@@ -1,51 +1,0 @@
-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/InstructionsPart1.txt
===================================================================
--- WAeUP_Doc/InstructionsPart1.txt	(revision 3029)
+++ WAeUP_Doc/InstructionsPart1.txt	(revision 3029)
@@ -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/InstructionsPart2.rst
===================================================================
--- WAeUP_Doc/InstructionsPart2.rst	(revision 1617)
+++ 	(revision )
@@ -1,93 +1,0 @@
-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/InstructionsPart2.txt
===================================================================
--- WAeUP_Doc/InstructionsPart2.txt	(revision 3029)
+++ WAeUP_Doc/InstructionsPart2.txt	(revision 3029)
@@ -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/InstructionsPart3.rst
===================================================================
--- WAeUP_Doc/InstructionsPart3.rst	(revision 1617)
+++ 	(revision )
@@ -1,66 +1,0 @@
-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/InstructionsPart3.txt
===================================================================
--- WAeUP_Doc/InstructionsPart3.txt	(revision 3029)
+++ WAeUP_Doc/InstructionsPart3.txt	(revision 3029)
@@ -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/InstructionsPart4.rst
===================================================================
--- WAeUP_Doc/InstructionsPart4.rst	(revision 1617)
+++ 	(revision )
@@ -1,49 +1,0 @@
-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/InstructionsPart4.txt
===================================================================
--- WAeUP_Doc/InstructionsPart4.txt	(revision 3029)
+++ WAeUP_Doc/InstructionsPart4.txt	(revision 3029)
@@ -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/InstructionsPart5.rst
===================================================================
--- WAeUP_Doc/InstructionsPart5.rst	(revision 1617)
+++ 	(revision )
@@ -1,44 +1,0 @@
-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/InstructionsPart5.txt
===================================================================
--- WAeUP_Doc/InstructionsPart5.txt	(revision 3029)
+++ WAeUP_Doc/InstructionsPart5.txt	(revision 3029)
@@ -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/InstructionsPart6.rst
===================================================================
--- WAeUP_Doc/InstructionsPart6.rst	(revision 1617)
+++ 	(revision )
@@ -1,11 +1,0 @@
-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/InstructionsPart6.txt
===================================================================
--- WAeUP_Doc/InstructionsPart6.txt	(revision 3029)
+++ WAeUP_Doc/InstructionsPart6.txt	(revision 3029)
@@ -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/InstructionsPart7.rst
===================================================================
--- WAeUP_Doc/InstructionsPart7.rst	(revision 1617)
+++ 	(revision )
@@ -1,46 +1,0 @@
-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/InstructionsPart7.txt
===================================================================
--- WAeUP_Doc/InstructionsPart7.txt	(revision 3029)
+++ WAeUP_Doc/InstructionsPart7.txt	(revision 3029)
@@ -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".
