[Gzz-commits] fenfire/docs/pegboard fenpdf_v1_1_spec_1--tjl/p...

[Tuomas J. Lukka]

CVSROOT:        /cvsroot/fenfire
Module name:    fenfire
Branch:         
Changes by:     Tuomas J. Lukka <address@hidden>        03/08/01 02:09:55

Modified files:
        docs/pegboard/fenpdf_v1_1_spec_1--tjl: peg.rst 
        docs/pegboard/fenpdf_v1_spec_1--tjl: peg.rst 

Log message:
        More, in response to benja

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/fenfire/fenfire/docs/pegboard/fenpdf_v1_1_spec_1--tjl/peg.rst.diff?tr1=1.3&tr2=1.4&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/fenfire/fenfire/docs/pegboard/fenpdf_v1_spec_1--tjl/peg.rst.diff?tr1=1.6&tr2=1.7&r1=text&r2=text

Patches:
Index: fenfire/docs/pegboard/fenpdf_v1_1_spec_1--tjl/peg.rst
diff -u fenfire/docs/pegboard/fenpdf_v1_1_spec_1--tjl/peg.rst:1.3 
fenfire/docs/pegboard/fenpdf_v1_1_spec_1--tjl/peg.rst:1.4
--- fenfire/docs/pegboard/fenpdf_v1_1_spec_1--tjl/peg.rst:1.3   Wed Jul 30 
06:23:50 2003
+++ fenfire/docs/pegboard/fenpdf_v1_1_spec_1--tjl/peg.rst       Fri Aug  1 
02:09:54 2003
@@ -3,8 +3,8 @@
 =============================================================
 
 :Author:   Tuomas J. Lukka
-:Last-Modified: $Date: 2003/07/30 10:23:50 $
-:Revision: $Revision: 1.3 $
+:Last-Modified: $Date: 2003/08/01 06:09:54 $
+:Revision: $Revision: 1.4 $
 :Status:   Incomplete
 
 This PEG is currently for storing those pieces of v1 spec
@@ -28,6 +28,10 @@
 
 - real merging
 
+- adjust view separation without middle button
+
+- content links
+
 Overall visuals
 ===============
 
@@ -42,7 +46,8 @@
 the old Tk look, with a square in them that is lit or unlit based on the state
 (need to distinguish between buttons and toggles somehow).
 
-They shall react to mouseovers and mouse clicks instantly with visual feedback.
+They shall react to mouseovers and mouse clicks instantly with visual feedback 
+(lighting up).
 
 
 Versioning / Merging
Index: fenfire/docs/pegboard/fenpdf_v1_spec_1--tjl/peg.rst
diff -u fenfire/docs/pegboard/fenpdf_v1_spec_1--tjl/peg.rst:1.6 
fenfire/docs/pegboard/fenpdf_v1_spec_1--tjl/peg.rst:1.7
--- fenfire/docs/pegboard/fenpdf_v1_spec_1--tjl/peg.rst:1.6     Wed Jul 30 
08:38:32 2003
+++ fenfire/docs/pegboard/fenpdf_v1_spec_1--tjl/peg.rst Fri Aug  1 02:09:55 2003
@@ -4,8 +4,8 @@
 
 :Authors:  Tuomas J. Lukka
 :Date-Created: 2003-07-28
-:Last-Modified: $Date: 2003/07/30 12:38:32 $
-:Revision: $Revision: 1.6 $
+:Last-Modified: $Date: 2003/08/01 06:09:55 $
+:Revision: $Revision: 1.7 $
 :Status:   Incomplete
 :Stakeholders: benja, mudyc, humppake
 :Scope:    Major
@@ -34,6 +34,33 @@
   Hmm, for v1.0 maybe we should have *either* clinks *or*
   pdf transclusions but not both?
 
+  RESOLVED: Later. Again, not absolutely vital
+
+  [benja]
+  If we have content links but not PDF transclusions, we need content
+  links to text -> bit difficult to show.
+ 
+  Or, a way to make a link between a node and an enfilade. That could
+  actually be good... hm. To the user, it would be functionally very
+  similar to a structlink.
+ 
+  Transclusion is probably better if we have only one of the two, but
+  having both would also be good.
+ 
+  If we have clinks, when the user has selected a piece of PDF, it would
+  be good to have a "Create link" button which creates a new paper with an
+  empty node that's linked to the PDF. Actually, would also be good to
+  have this when the user is on a canvas and has selected a text node.
+  Then this would be a simple, universal way of creating a new annotation
+  to something.
+ 
+  Or maybe "make paper" should always work like this if there's a selected
+  node? When making a new paper, you almost always want it to be linked to
+  the current paper?
+ 
+  For text nodes it could also be in the context menu (if we don't have a
+  way to select them in the interface)...
+
 - RDF for cursors / bookmarks? Is just two views good enough
   for browsing? Accidental severing of contacts. Need some way to get anywhere.
 
@@ -64,7 +91,52 @@
 
   PROPOSED RESOLUTION: Use TREETIME and provide interface for it.
 
-- What were benja's suggestions - couldn't find a PEG
+- [benja] How is TREETIME supposed to be *shown*?
+
+- [benja] Will transclusions of *text* be supported, and if so, how?
+
+  PROPOSED RESOLUTION: Later
+
+- [benja] I don't like the overloading of click+drag. Isn't there a
+  better way? Maybe Shift+drag to create the transclusion after
+  selecting? Hm.
+
+  RESOLUTION: Shift+drag is not possible, as it needs to 
+  start another selection reliably. See next issue.
+
+- [benja] What actions *destroy* the current selection (unselect it)?
+  Should every click destroy the selection? (Even panning?) If so, maybe
+  the click+drag to create transclusion could be tolerable.
+
+  RESOLUTION: Yes, every click destroys the selection. This way,
+  there will be no annoying things that get easily stuck.
+ 
+- [benja] Shift+click+drag is certainly not something you can figure
+  you can just figure out (see requirements). What to do about that?
+
+  PROPOSED RESOLUTION: Text in the background always: shift-drag to select?
+ 
+- [benja] How to adjust the view separator position without middle button?
+
+  RESOLUTION: Later - in 1.1. In 1.0, assume middle button.
+
+- [benja] How to create structlinks
+
+- [benja] This describes only mouse bindings. How does the keyboard work?
+  How is a new node created? How do I edit an existing node? Is a text
+  cursor shown, and when, and how does it work? These need to be specified.
+ 
+- [benja] How to move nodes on a canvas? Rearrangement seems quite
+  important, so it would be bad to leave it to a later version.
+ 
+- [benja] Can I enter text in both foci, or only in one?
+ 
+- [benja] How to unlink two nodes on same paper?
+
+  RESOLUTION: In v1.0, the nodes would be shown as buoys,
+  so in the usual way.
+
+
 
 Introduction
 ============
@@ -139,10 +211,9 @@
 User interface
 ==============
 
-While the Structure was an important part, the user interface is the most 
*difficult* one.
-There are several possible directions and we need to select one for FenPDF 1.0.
-
-One that we will provide as a backwards-compatibility option in later versions 
of FenPDF
+While the Structure is an important issue, the user interface is the most 
*difficult* one.
+There are several possible directions and we need to select one for FenPDF 1.0 
---
+one that we will provide as a backwards-compatibility option in later versions 
of FenPDF
 if it is seen to be good.
 
 Requirements
@@ -178,6 +249,8 @@
     The buoy should show some context but not too much
     to avoid going to too small zoom.
 
+    These are shown for structlinks and nothing else.
+
 Canvas-PDF Transclusion
     Always to the right.
     Max. 20 pages of the whole document are shown.
@@ -188,6 +261,11 @@
     Here, enough context needs to be shown since the transclusion 
     is just the same as the anchor.
 
+Treetime interface
+------------------
+
+Show small buoy-like things at very edge of screen horizontally for 
+next and previous canvas.
 
 
 Bindings
@@ -198,19 +276,23 @@
     click
        go to
 
-    click + drag on main view
+    click + drag on focused node
        pan
 
-    shift + click + drag on main view
+    shift + click + drag on focused node
        select
 
-    click + drag on a selection in main view
-       drag into other view for creating transclusion
+       On PDF view, select rectangle
+
+       On canvas view, select part of text
+
+    click + drag on a selection in focused node (PDF only)
+       drag into other view (Canvas) for creating transclusion
 
 
 Right mouse button:
     
-    click + drag on main view
+    click + drag on focused node
        adjust zoom. Up = zoom out, down = zoom in.
 
     click
@@ -221,7 +303,7 @@
     click + drag anywhere
        move view separator up / down
 
-    click on main view
+    click on focused node
        X11 paste to insertion cursor
 
 Context Menus
@@ -229,7 +311,7 @@
 
 On struct-connected buoys: "Unlink this buoy"
 
-For any object, "Delete this X" where X is "Text", "Paper", "PDF file", 
"transclusion"
+For any object, "Delete this X" where X is "Text", "Paper", "PDF file", 
"transclusion", "structlink"
 
 
 Visible buttons
@@ -237,19 +319,22 @@
 
 Action buttons everywhere:
 
+    Home
+
+    Save
+
     Import PS/PDF
 
     New paper
 
-    Save
 
-    Quit
+    Save & Quit
 
 Toggles everywhere:
 
-    Fancy papers
+    Show bgs
 
-Toggles in pdf mode:
+Toggles in pdf mode (i.e., when a PDF node is focused):
 
     Reading zoom