As-gui Sources: TODO@d64aaa7d146f (annotated)

TODO@d64aaa7d146f (annotated)

TODO

Fri, 28 Nov 2008 11:21:08 +0100

author: Michael Schloh von Bennewitz <michael@schloh.com>
date: Fri, 28 Nov 2008 11:21:08 +0100
changeset 1: d64aaa7d146f
child 12: ceb4ba3d2d00
permissions: -rw-r--r--

Fork project trunk at version 0.7.7 to maintain for future usage.
The original Cable & Wireless development team no longer exists.
The OSSP CVS repository is unavailable (cvs co ossp-pkg/as fails),
however http://cvs.ossp.org/dirview?d=ossp-pkg/as/as-gui is working.

                    ***************************************
                    *                                     *
                    *   TODO: OSSP titraq Specification   *
                    *                                     *
                    ***************************************
 Must do
 -------
 Q_CHECK_PTR
 public/private
 Ensure rethrows from second loadData on upwards
 Report errors in all slot code
 Rework error handling in prefs
 Generally maintain Preference class
   Implement missing interface methods
 Review destruction of all members, compare with setupPrefs
 Some menus are defined QPopupMenu in header, some in code
 Memory optimization needed in tidataops
 Check all identifiers for undeutig unique scope
 Remove magic numbers from cpp files to titconst like TITRAQ_INDEXREMARK
 Some signals implemented in Titraqform really belong in satellite classes
 Write M4 macro for detecting cuserid, and prefer it in ac_assist
 configure soll ueberpruefen ob libqt[-mt] threads braucht,
   dann wenn so, soll den LIBS -pthread hardgecodet haben
 Read config location from optional --confgen autoconf location
 IDs in as_const.h much better choosing, so they make sense
 Be consistent with szQString vs QString var names
 After every result write a status bar message
 On multiple selection, no text should appear in edit ctrls
 Make consistent setEdition(), setDirty() default parameters
 Use namespace 'AS' or unique identifier 'AS' for all classnames
 Unify class mycl = class(), class mycl(), class *pMycl, auto_ptr<class *>
 Win32 code in User class is only half written, and incomplete homedir
 Verify routine consistently scans all fields on load and new entries
 Remove all exception raises from slot code
 New doc, new entry, change text in table, close... No verify save!
 Might not need classes Amount and Tableitem at all
 Mach mal mit den 'autobackup' und 'fextension' Optionen von prefs
 Check for outdated config file version
 Make status bar message, qWarning, qDebug, and Popup messages consistent
   For which purposes do messages go in each category?
 Label methods and parameters throughout as const ... const, use &
 Yank out all #include from headers, replace with class ...; protos
 Check for empty amount field in getWeektotals before Hashtasks[Convstring] +=
 Accountlistbox is sorted both in assist and dataops with maps
 Verify that unviewable rows are not redrawn cerr << "Rownum" << nRow << endl;
 Also, use bool QTable::isRowHidden (int nRow) const
 Don't raise the question 'Save before quitting' when no contents were changed
 Bugs (? = unverified)
 ---------------------
 Overidden paintCell() might not work when called asynchronously?
 Sometimes a click on add or delete toolbar button is ignored?
 When multiple new rows are added sometimes wrong row shading?
 When sorting rows, sometimes a false extra highlight appears
 Disabled actions still show enabled icons in menu popups
 Pressing escape on task data cells does not exit edit mode
 On win32, all or some file reads and writes probably need IO_Translate?
 Method saveData(stream) must write to a new file, otherwise writes data pattern
 CRCs are being generated before parsing of "" is finished?
 Double click on column separator is broken again
 Zeitabzug moeglicherweise falsch wenn 23:00-01:00=?
 Statustext soll nicht neben Pixmaps erscheinen
 Loesch mal alle Text vom Task Editctrl, dann drueck mal Obentaste
 Memory leak in vector<QRadioButton> as_panel
 Opendoc, schau amount unten Knopf (ist dimmed)
 Reporting only works if event data is sorted by date
 Press Return then Tab many times to see invalid selections
 Does not enter edit mode for a cell when double click
 Some versions (as.de.cw.net:/v/as-old/sw), double click to
   edit a cell, add two characters, click X to close without
   leaving the cell. It should ask to save doc, but doesn't.
 Nice to have
 ------------
 Implement drag and drop selected row swapping
 Implement an unlimited and generic undo and redo buffer class
 Support pasting into as_gui from other app (like vim)
 Add optional automatic file personal data file backup
 Make edit control window optional through preferences
 Add customizable column ordering by click and drag
 Soll mehr intuitive, mit sekondaer/dritte Keycolumn
 CRC und Rev sollen nicht in gleiche Methode berechnet
 No need to have upd slots for non-changeable upd controls
 Before openDoc, closeEvent should be used instead of new code
 Align CRC field data to left edge of table items
 Make Simplefile class non-Qt specific
 Read and write karm format files with file extension detection
 Offer general option 'Use vim keymap'
 Text revisions
   Title case, sentence case, or lower case
   Past tense, third person, style, usage...
 Make consistent when version is shown in titlebar of all dialogs
 Runtime help system should not depend on installtime documentation
 App should start even if no accounts file is found
 Fully vimize all input widgets by subclassing them (w - back word)
 Reload accountlist on startup, but reload during 'Open Doc' as well
 Better file validation, instead of just single line validateData op
 Freetext field, for copyright or some announcement (this data isn't
   accurate enough for billing purposes). Field can be optionally
   shown above main table, but always dimmed to avoid accidental edit.
 Check for account list updates (checkbox), to allow a local user to
   query a CORBA or SOAP server for a new account list via accessors:
     U32 Account::getCrc(void)
     Acctlist Account::getData(void)
 Reimplement void QTable::swapRows, so that rows can be moved easily
 Update edit controls only after return from TiTable::createEditor()
 Screwey user notes ;-)
 ----------------------
 cs:  'd' should not delete at once but flag the record as deleted.  Use '$' to sync (similar to mutt)
 cs:  first 'TAB' should complete (if possible), second 'TAB' should open selection box (similar to bash)
 cs:  line numberscould be referenced when entering accounts ala bash history ('!4' = record #4)
 mlelstv: 24:00 muss als Valideintrag im Finishfeld erlaubt
 thl: / should enable the user to search for something
 thl: using = should force a recalculation for a time field
 thl: using ~ should round a time field to the next quarter (configurable)
 Architectural
 -------------
 Decouple form, preferences, and RPC classes
 Remove common class behaviours (quitApp, close...) to abstract classes
 Win32
 -----
 Rework username, homedir, and confdaten (hive) logic
 Preferences
 -----------
 <option name wert>      Hintergrund Functionalitaet
 <aspect name wert>      Sichtliche Functionalitaet
 <session name wert>     Automatisch gespeicherte
 <rule name expr cond>   Amount = Finish - Start (mussen alle da z.B.)
 <alias name wert>       Nutzbar lange Taskzeilen zu abstrahieren
 <macro name = 'Reuse'>
   Selectiere aktuelle und 3 vorherige Reihen
   Copy
   Geh zu letzte Reihe
   Paste
 </macro name = 'Reuse'>
 <macro name = 'Append'>
   Geh zu letzte Reihe
   Zufug Reihe
 </macro name = 'Append'>
 Code snippits
 -------------
 // Portable processes
 QProcess *Proc;
 Proc = new QProcess;
 Proc->setArguments("/usr/local/bin/nada");
 bool ok = Proc->start();
 > Does anyone know how to set the WhatsThis text for a QPushButton?.
 >
 > Met vriendelijke groet
 Use the static QWhatsThis::add()
 Document
 --------
 Use doxygen for C++ interface documentation.
 Project plan
 ------------
     Prototype
     Release v0.8    Milestone 1, Alpha
     Release v0.9    Milestone 2, Beta
     Release v1.0    Milestone 3,
     Release v1.2    Milestone 4,
 Requirements
 ------------
 Deliverables
 ------------
     Binaries
       titraq           Verwendung
     Designdocs
       titraq_design.ps Systemdiagramme
     Manpage
       titraq.1         Hauptinfo
       titraq.conf.5    Beschreibung des Configdatei
     Geliefert
       titraq.conf      Ausgekommentet Beispieldatei
 Pseudocode
 ----------
     initialize
     parse command line
     parse titraq.conf file
     load titraq.dat file
     show control window
     wait for quit
     save titraq.dat file
     finish
 Test case
 ---------
     Pre:
     tar zxvf titraq-0.9.tar
     cd titraq-0.9
     ./configure
     make
     su
     make install
     Assume:
     OS has Qt 3.0.6 or newer multithreaded library
     Begin:
     $ titraq
     Output:
     Post:
     Procedure:
                 ****************************
                 *                          *
                 *  Inadequacies of as-gui  *
                 *                          *
                 ****************************
 Architecture Inconsistencies
   o Some custom classes are thinly veiled Qt classes. Others
     are completely different, but with similar functionality.
   o Several classes are immense, and should be split into
     into easier to read pieces.
   o Some classes should be abstracted and new subclasses built.
 Implementation
   o Too procedural for my taste. Many methods should be merged
     or split and grouped into new classes or such.
 Naming
   o Hungarian notation is only used to 90% potential.
   o Inconsistent length and abbreviations.
   o Conventions suggested on Qt website not followed.
 Error handling
   o No standardized return values.
   o C++ exceptions used inconsistently.
 Memory handling
   o Smart pointers should be used in all exception code blocks.
   o A consistent policy of automatic versus dynamic pointer
     variables should be used in all classes.

As-gui Sources / annotate

TODO@d64aaa7d146f (annotated)

TODO