src/Tools/isac/Doc/Specify_Phase/document/user-requirements.tex
changeset 60197 c5fb7a731771
parent 60189 6b021e8cb8da
child 60207 454a399ae576
equal deleted inserted replaced
60196:2be9a67fec59 60197:c5fb7a731771
     1 %:wrap=soft:maxLineLen=78:
     1 %:wrap=soft:maxLineLen=78:
       
     2 
       
     3 \chapter{Preliminaries}
       
     4 %############################################################################
     2 
     5 
     3 \section{List of terms used in the \isac-project}\label{terms}
     6 \section{List of terms used in the \isac-project}\label{terms}
     4 %============================================================================
     7 %============================================================================
     5 This list follows the original one in \cite[Appendix D]{isac:all}. It is a 
     8 This list follows the original one in \cite[Appendix D]{isac:all}. It is a 
     6 selection concerning the specify-phase. In particular, the terms used for this 
     9 selection concerning the specify-phase. In particular, the terms used for this 
    84 The User Requirements ({\bf UR}s) do not follow the lines of the original ones 
    87 The User Requirements ({\bf UR}s) do not follow the lines of the original ones 
    85 in \cite[Part I]{isac:all}, but limit themselves to a student in the 
    88 in \cite[Part I]{isac:all}, but limit themselves to a student in the 
    86 specify-phase and use the updated terms from \S\ref{terms} (which are 
    89 specify-phase and use the updated terms from \S\ref{terms} (which are 
    87 indicated by initial capital letters).
    90 indicated by initial capital letters).
    88 
    91 
       
    92 \subsection{General}
       
    93 %----------------------------------------------------------------------------
       
    94 {\bf\UR{The screen-reader superimposes the Braille display \label{sreader-braille}}} in the software hierarchy, i.e. the former determines output of the latter.
       
    95 
       
    96 \subsection{Specify Phase}
       
    97 %----------------------------------------------------------------------------
    89 {\bf\UR{Examples are selected from 
    98 {\bf\UR{Examples are selected from 
    90 collections\label{example-coll}}}\footnote{The present test setup bypasses 
    99 collections\label{example-coll}}}\footnote{The present test setup bypasses 
    91 this UR.}
   100 this UR.}
    92 implemented on web-pages, which look like a text book. A specific link at an 
   101 implemented on web-pages, which look like a text book. A specific link at an 
    93 Example starts an interactive Calculation for that Example. See 
   102 Example starts an interactive Calculation for that Example. See 
   136 ``(RMethod)''.
   145 ``(RMethod)''.
   137 \end{compactitem}
   146 \end{compactitem}
   138 
   147 
   139 {\bf\UR{The Model can be switched between RProblem and RMethod,\label{yyy}}} 
   148 {\bf\UR{The Model can be switched between RProblem and RMethod,\label{yyy}}} 
   140 where the latter is indicated by ``Model (RMethod)''< see Expl.\ref{tab:refs}.
   149 where the latter is indicated by ``Model (RMethod)''< see Expl.\ref{tab:refs}.
       
   150 
       
   151 \subsection{Terms}
       
   152 %----------------------------------------------------------------------------
       
   153 {\bf\UR{Terms are presented as strings in Braille format\label{term-str}}} for 
       
   154 the blind user and as Isabelle strings for other users at the same time --- 
       
   155 for the purpose of inclusive learning in front of one and the same screen. 
       
   156 ?TODO is this reasonable?
       
   157 
       
   158 {\bf\UR{The Braille-format can be changed\label{braille-format}}} to different 
       
   159 standards.
       
   160 
       
   161 {\bf\UR{Sub-terms are presented as strings\label{sub-term-str}}} the same way 
       
   162 as whole terms. The location within the whole term is indicated by ?TODO?
       
   163 
       
   164 {\bf\UR{A term can be shown as a tree\label{term-tree}}} if requested by a 
       
   165 special key, TODO. The key followed by an integer argument determines the 
       
   166 depth of the tree. For instance $<$TODO 1$>$ displays the term 
       
   167 $\frac{\frac{1}{x}}{\frac{2}{y}}$ 
       
   168 \begin{tabbing}
       
   169 with argument \=$/$ \=1 / x 1234567890\=$/$ \=$/$ \=\=\kill
       
   170 with argument \>$1$ \>                \>$2$       \\
       
   171               \>$/$ \>                \>$/$       \\
       
   172               \>    \> 1 / x          \>\>$/$     \\
       
   173               \>    \> 2 / y          \>\>\> 1    \\
       
   174               \>    \>                \>\>\> x    \\
       
   175               \>    \>                \>\>$/$     \\
       
   176               \>    \>                \>\>\> 2    \\
       
   177               \>    \>                \>\>\> y
       
   178 \end{tabbing}
       
   179 TODO?: ``Dann eine Taste definieren, durch deren Dr\"ucken das Innere des 
       
   180 ersten Klammerpaares - Z\"ahler - genauer angezeigt wird, sobald sich der 
       
   181 Cursor auf einer der begrenzenden Klammern befindet.
       
   182 Umgekehrt: Stehe ich irgendwo im Z\"ahler eines Bruches, dann soll es eine 
       
   183 Taste geben, mit der sich der Z\"ahler zu einem geschweiften Klammerpaar 
       
   184 verdichtet, vielleicht sogar eine Taste, mit der der Nenner das gleichzeitig 
       
   185 auch tut.''
       
   186 
       
   187 {\bf\UR{Navigation through sub-terms is hierarchical\label{navi-sub-terms}}} 
       
   188 and supported by a special key combined with the arrow keys as follows:
       
   189 \begin{compactenum}
       
   190 \item $<$STRG$>$ $<\rightarrow>$ next element right on the same level; 
       
   191 acoustical indication at the end of the level.
       
   192 \item $<$STRG$>$ $<\leftarrow>$ next element left on the same level; 
       
   193 acoustical indication at the end of the level.
       
   194 \item $<$STRG$>$ $<\uparrow>$ next element on the higher level; acoustical 
       
   195 indication at the root.
       
   196 \item $<$STRG$>$ $<\downarrow>$ next element on the lower level; acoustical 
       
   197 indication at the bottom.
       
   198 \end{compactenum}
       
   199 
       
   200 {\bf\UR{Semantic information is available for all elements of 
       
   201 terms.\label{term-semantic}}} Such information is:
       
   202 \begin{compactenum}
       
   203 \item the type for constants and variables by a pop-up.
       
   204 \item the scope of a variable by (TODO ``internal'' and ``global'' seems to 
       
   205 coarse).
       
   206 \item the definition of constants and variables by jumping to the respective 
       
   207 location, probably in another file.
       
   208 \end{compactenum}
   141 
   209 
   142 %{\bf\UR{xxx.\label{yyy}}}
   210 %{\bf\UR{xxx.\label{yyy}}}
   143 
   211 
   144 
   212 
   145 \section{Example Calculations}
   213 \section{Example Calculations}