NOTES.org

   1 #+TITLE: Development notes/ideas
   2
   3 * Planned improvements
   4
   5 ** TODO Allow multiple elpher buffers
   6
   7    Shouldn't be too hard, just need elpher-current-node to be
   8 buffer-local and allow various buffer-switching procedures to
   9 do something sensible.
  10
  11 ** TODO Remove "redraw" command
  12 This is only necessary for returning from displaying the raw
  13 server response.  If I can provide a better way of doing that
  14 then we can get rid of redraw entirely.
  15
  16 ** TODO Replace support for user-specified starting pages
  17 This used to be available, but was removed during a refactor.
  18
  19 ** TODO Allow for grouping of bookmarks
  20 To support this I'd like to add a bookmark page specific
  21 set of keybindings.  Currently all bindings available on
  22 the bookmark page are available everywhere else.  But
  23 expanding and collapsing bookmark groups sounds like it
  24 might need more specific bindings.
  25
  26 ** IN-PROGRESS Implement Gemini support [88%]
  27
  28 Here is the checklist of features required before release:
  29 - [X] basic genimi transactions
  30 - [ ] gemini transactions requiring client certificates
  31 - [X] gemini input handling
  32 - [X] gemini map files (text/gemini)
  33 - [X] Support for plain text responses (text/*)
  34 - [X] Support for image responses (text/image)
  35 - [X] Support for mime-specified character encodeing
  36 - [X] Saving responses to disk
  37 - [X] Viewing raw responses
  38
  39 The last few will be made infinitely easier if we factor the
  40 gopher "getter" code differently.
  41
  42 * Current issues
  43
  44 * Completed improvements
  45
  46 ** DONE Turn on lexical scoping
  47
  48    A branch exists for this, but there are some compilation kinks
  49 to iron out.
  50
  51
  52 ** DONE Implement support for telnet entries
  53
  54 Similar to http entries, telnet entries will be handled by code
  55 external to elpher. However it seems I made http entry handling a
  56 special case, and I don't want another!  So the only option is to
  57 bring both http and telnet entries back into the fold by representing
  58 them both as standard nodes and having the grunt work done by getter
  59 functions.
  60
  61 ** DONE Allow users to access selected and current node details.
  62
  63 ** DONE Implement bookmark system
  64
  65   Currently the bookmark page replaces the current page, and it
  66   does so silently (i.e. it doesn't become part of the link hierarchy).
  67   I think this is a mistake, as it results in confusing behaviour when
  68   traversing the link hierarchy after visiting one of the bookmarked links.
  69
  70   Instead, I think I should
  71   1. Make the bookmark page part of the hierarchy, and
  72   2. Reinstate the visited node hash table to avoid excess link hierarchy pollution.
  73
  74   In order to accomplish 1. it will be necessary to make the bookmark page renderer
  75   a proper getter function, and one that never caches the contents of the buffer.
  76
  77   Actually, I might have to think about that a bit more.  I don't know
  78   how to answer the question of what the best thing to do with node
  79   parent links when using a cached node in place of a new node.  (Maybe
  80   I always update node.parent unless parent is already an ancestor of
  81   node?)
  82
  83
  84 ** DONE Support character encoding diversity
  85
  86 ** DONE Make URLs the basic address type.
  87 Currently I waste a lot of effort converting between
  88 URL and non-URL representations.  This is unnecessary, and
  89 actually makes lots of things uglier.
  90
  91 For example, the bookmarks file contains addresses in Elpher's
  92 internal representation, whereas I expect users would prefer
  93 it contain URLs.
  94
  95 So the idea would be for (elpher-node-address node) to be
  96 a either a string or a symbol, with symbols used for "special"
  97 pages (bookmarks, start page, etc).  The getter functions
  98 `elpher-address-selector' etc will still do what they currently
  99 do, but will process the URL to do it.
 100
 101 This also means that non-gopher URLs will be explicitly represented
 102 as such: no more abusing the "h" type for these.
 103
 104 * Old issues
 105
 106 ** DONE Org mode faces are not present in recent emacs versions
 107 Even 26.1 doesn't seem to have these.  This means that, for many
 108 users, elpher doesn't show any difference between any of the
 109 item types.  Not a major problem at all, but the faces we inherit
 110 from should definitely be ones which have been present for much
 111 longer.  Perhaps the font lock mode faces are the way to go after
 112 all.
 113
 114 Update: changed all default faces to inherit from font-lock and basic faces.
 115
 116 ** DONE URL-centric addressing breaks bookmark file compatibility
 117
 118 Need a way to allow people to rescue their old bookmark files
 119 following this update.