citadel/techdoc/views.txt

   1 How "views" work in Citadel (beginning with v6.00)
   2 --------------------------------------------------
   3
   4  (Note: this stuff isn't finished yet; we're still building the framework.)
   5
   6  There's no need to be rigid and stupid about how different rooms are presented
   7 in a Citadel client.  And we don't enforce things either.  But there's a need
   8 to make things look the way the user wants to see them.  For example, we might
   9 always choose to see a room full of private mail as a summary (one line per
  10 message) rather than always dumping out the entire contents like we do on a
  11 typical BBS room.  An address book room might look better as a tabbed view
  12 or something, rather than as a bunch of messages with vCards attached to them.
  13
  14  This is why we define "views" for a room.  It gives the client software a
  15 hint as to how to display the contents of a room.  This is kept on a per-user
  16 basis by storing it in the 'visit' record for a particular room/user
  17 combination.  It is visit.v_view and is an integer.  Naturally, there also
  18 needs to be a default, for users who have never visited the room before.  This
  19 is in the room record as room.QRdefaultview (and is also an integer).
  20
  21  The values currently defined are:
  22
  23 #define VIEW_BBS                0       /* Traditional Citadel BBS view */
  24 #define VIEW_MAILBOX            1       /* Mailbox summary */
  25 #define VIEW_ADDRESSBOOK        2       /* Address book view */
  26