diff --git a/changelog.markdown b/changelog.markdown --- a/changelog.markdown +++ b/changelog.markdown @@ -1,3 +1,6 @@ # 2013-07-04 Dr. Alistair Ward ## 0.0.0.1 + +## 0.0.0.2 +Updated list of test-compilers. diff --git a/debian/DEBIAN/control b/debian/DEBIAN/control --- a/debian/DEBIAN/control +++ b/debian/DEBIAN/control @@ -1,5 +1,5 @@ Package: weekdaze -Version: 0.0.0.1-1 +Version: 0.0.0.2-1 Section: utils Priority: optional Architecture: amd64 diff --git a/man/man1/weekdaze.1 b/man/man1/weekdaze.1 --- a/man/man1/weekdaze.1 +++ b/man/man1/weekdaze.1 @@ -213,13 +213,9 @@ .br The undesirable consequence is that teacher \fIT1\fR must synchronise progress through the \fIcourse\fR, between these \fIstudent-class\fRes. .TS -l l cb s s -l l c s s lb lb l l l ^ lb ^ ^ ^ l l l l l . - Time - ============ Teacher Student t1 t2 t3 body ======= ======= == == == @@ -242,13 +238,9 @@ under these circumstances no undesirable \fIstudent-body combinations\fR can arise, but should their \fIavailability\fR dictate that they must form four singleton \fIstudent-class\fRes, different pairs of singleton \fIstudent-class\fRes may be synchronised @ various \fItime\fRs throughout the week. .TS -l l cb s s s -l l c s s s lb lb l l l l ^ lb ^ ^ ^ ^ l l l l l l . - Time - ====================== Teacher Student t1 t2 t3 t4 class ======= ======= == == == == @@ -520,18 +512,13 @@ .TS lb lb l l -lb l -. +lb l . Report Explanation -===== =========== +====== =========== The weighted mean over all heterogeneous timetable-criteria, of the deterministic timetable resulting from each raster-scan; & the (minimum, maximum) The application has performed a raster-scan over the timetable, booking \fIlesson\fRs selected to optimise the value of \fIlesson-criteria\fR. This is repeated using a variety of different rasters, reporting for each the resulting weighted mean over all \fItimetable-criteria\fR. Finally the raster-patterns which were worst & best are reported. - The weighted timetable-criteria of the best deterministic timetable The individual \fItimetable-criteria\fR used to compose the weighted mean, in the best raster-scan, are reported in the configured order. - The ((mean, standard deviation), (minimum, maximum)) over the best deterministic timetable, of each weighted lesson-criterion The values of \fIlesson-criteria\fR, by which \fIlesson\fRs were selected during the best raster-scan are reported. Their standard deviation, & minimum & maximum value, over the best timetable, identifies their influence on the selection of \fIlesson\fRs, & where perhaps individual weights may be fine-tuned. This is the end of the initial deterministic phase, from which random evolution now begins. - The (relative improvement in the weighted mean over all heterogeneous timetable-criteria, the number of generations through which the timetable evolved, the final fecundity, & the weighted timetable-criteria for the selected candidate), for each evolution-strategy/timetable-constructor Here we report four statistics for each evolution/reconstruction strategy; a quantification of the improvement according to the weighted mean over all the \fItimetable-criteria\fR, resulting from this strategy; the number of generations of evolution, since strategies are terminated when improvements cease; the final \fIfecundity\fR of the breeding-program, since this is reduced by a feedback-loop, when the population-diversity ratio of the candidate-population drops beneath a threshold; the individual weighted \fItimetable-criteria\fR, in configuration-order, from which the mean is composed. - The final weighted timetable-criteria, & the improvement, from the best deterministic timetable The final value of each weighted \fItimetable-criterion\fR is reported, along with the absolute amount by which it was changed during evolution. The order in which they're reported matches the configured "\fBtimetableCriteriaWeights\fR". .TE .sp 1 @@ -692,7 +679,7 @@ .fi .IP \(bu The executable was in this instance built with the \fBCabal\fR-flag "\fB-fHDBC-mysql\fR" to connect to the data-server using the native \fBMySQL\fR-interface, -so data-server connection-parameters had to be specified on the command-line, rather than via a \fB.ODBC.ini\fR file. +so data-server connection-parameters had to be specified on the command-line, rather than via a \fB.odbc.ini\fR file. .br I could also have explicitly specified \fB--dataServerHost\fR='127.0.0.1' \fB--dataServerPort\fR='3306' \fB--dataServerUserId=\fR'root' \fB--databaseName=\fR'weekdaze', but these are the defaults (though a less privileged database-user would be preferrable). diff --git a/man/man5/weekdaze.5 b/man/man5/weekdaze.5 --- a/man/man5/weekdaze.5 +++ b/man/man5/weekdaze.5 @@ -124,18 +124,18 @@ for each of the \fIdepletion-strategies\fR (defined in section-1 of the man-pages). .sp 1 .nf -.B synchronisedCourseByDayMutation -.B synchronisedCourseMutation -.B excessRunlengthMutation -.B homogeneousStudentViewLessonMutation -.B incompleteCourseMutation -.B randomLessonMutation -.B singletonStudentClassMutation -.B splitSessionMutation -.B studentBodyCombinationMutation -.B studentViewTimetableForDayMutation -.B studentViewTimetableForWeekMutation -.B synchronousLessonMutation +\& \fBsynchronisedCourseByDayMutation\fR, +\& \fBsynchronisedCourseMutation\fR, +\& \fBexcessRunlengthMutation\fR, +\& \fBhomogeneousStudentViewLessonMutation\fR, +\& \fBincompleteCourseMutation\fR, +\& \fBrandomLessonMutation\fR, +\& \fBsingletonStudentClassMutation\fR, +\& \fBsplitSessionMutation\fR, +\& \fBstudentBodyCombinationMutation\fR, +\& \fBstudentViewTimetableForDayMutation\fR, +\& \fBstudentViewTimetableForWeekMutation\fR, +\& \fBsynchronousLessonMutation\fR. .fi .sp 1 CAVEAT: the default \fIfecundity\fR of \fB0\fR, deactivates the corresponding \fIevolution-strategy\fR. @@ -743,7 +743,7 @@ l l l l l l 1 1 1 1 1 1 1 1 l lb r r lb lb l 1 1 1 1 1 1 1 1 l . File-name Time-slots Student XHTML-output XML-output Configuration-features -(xml/*.xml) per day bodies (xhtml/*.xhtml) (xml/*.xml) generateLessonColourFrom campus facilityName freePeriodPreference groupId maximumClassSize minimumConsecutiveLessons specialtyTopic synchronisationId timeslotRequest +xml/*.xml per day bodies xhtml/*.xhtml xml/*.xml generateLessonColourFrom campus facilityName freePeriodPreference groupId maximumClassSize minimumConsecutiveLessons specialtyTopic synchronisationId timeslotRequest ========= ========== ======= ============ ========== ======================== ====== ============ ==================== ======= ================ ========================= ============== ================= =============== example_01 1 3 timetable_01 studentViewTimetable_01 Y example_02 2 2 timetable_02 studentViewTimetable_02 Y Y Y Y @@ -757,12 +757,15 @@ .TE .sp 1 CAVEAT: should any of these files be relocated, then its "\fBDOCTYPE\fR"-declaration, will need to be corrected to reference \fBweekdaze.dtd\fR. +.sp 1 .TS lb lb +l s l l -l l . -\fBFile-name\fR (dtd/*.dtd) Contents -===================== ======== +lb l . +File-name Contents +dtd/*.dtd +========= ======== locationViewTimetable The formal description of the XML-format for the resulting timetable as seen from the perspective of \fIlocation\fRs. studentViewTimetable The formal description of the XML-format for the resulting timetable as seen from the perspective of \fIstudent-bodies\fR. teacherViewTimetable The formal description of the XML-format for the resulting timetable as seen from the perspective of \fIteacher\fRs. @@ -771,10 +774,12 @@ .sp 1 .TS lb lb +l s l l -l l . -\fBFile-name\fR (sql/*.sql) Contents -===================== ======== +lb l . +File-name Contents +sql/*.sql +========= ======== weekdazeCreate Defines the database-schema; all the tables & all the rows. weekdazeTriggers Defines extra rules required to preserve relational integrity as data is inserted. weekdazeExamples Defines a set of example timetable-problems (the same as those defined in XML). diff --git a/weekdaze.cabal b/weekdaze.cabal --- a/weekdaze.cabal +++ b/weekdaze.cabal @@ -14,7 +14,7 @@ -- along with WeekDaze. If not, see . Name: weekdaze -Version: 0.0.0.1 +Version: 0.0.0.2 Cabal-version: >= 1.10 Copyright: (C) 2013-2015 Dr. Alistair Ward License: GPL @@ -25,7 +25,7 @@ Build-type: Simple Description: An application which searches for a solution to the configured school-timetable problem. Category: Application, Teaching -Tested-with: GHC == 8.0, GHC == 8.2, GHC == 8.4, GHC == 8.6 +Tested-with: GHC == 8.0, GHC == 8.2, GHC == 8.4, GHC == 8.6, GHC == 8.8, GHC == 8.10 Homepage: https://functionalley.com/WeekDaze/weekdaze.html Maintainer: mailto:weekdaze@functionalley.com Bug-reports: mailto:weekdaze@functionalley.com @@ -55,6 +55,10 @@ README.markdown weekdaze.spec weekdaze.svg + +source-repository head + type: git + location: https://github.com/functionalley/WeekDaze -- Enable using: 'runhaskell Setup configure -f HDBC-mysql --verbose'. flag HDBC-mysql diff --git a/weekdaze.spec b/weekdaze.spec --- a/weekdaze.spec +++ b/weekdaze.spec @@ -24,7 +24,7 @@ Summary: Attempts to find a timetable satisfying the configured requirements. Name: weekdaze -Version: 0.0.0.1 +Version: 0.0.0.2 Release: 1 License: GPLv3 # From '/usr/share/doc/packages/rpm/GROUPS'.