<TeXmacs|0.3.5.6>

<style|manual>

<\body>
  <chapter|A first meeting with TeXmacs>

  <section|Starting TeXmacs up>

  You may start TeXmacs by typing

  <\verbatim>
    \ \ \ \ texmacs &
  </verbatim>

  The first time that you start TeXmacs, the program will analyze your system
  in order to test whether all other packages which are needed by TeXmacs are
  present on your system. If no problems occur, then a <with|font
  shape|italic|window> with the following aspect should appear on your
  screen:

  <expand|big-figure|<postscript|../Images/start.png|/2|/2||||>|Window which
  appears when starting TeXmacs up.>

  If this is not the case, then the messages displayed by TeXmacs may help
  you to track down possible installation problems. In the case that you do
  not manage to get TeXmacs working, you may <hlink|consult the TeXmacs
  web-pages|http://www.texmacs.org> on

  <\verbatim>
    \ \ \ \ http://www.texmacs.org
  </verbatim>

  or you may contact the author of TeXmacs at

  <\verbatim>
    \ \ \ \ vdhoeven@texmacs.org
  </verbatim>

  <section|Understanding the TeXmacs window>

  The following figure illustrates some common notions, like menu, scrollbar,
  etc., which will be frequently referred to in this manual:

  <expand|big-figure|<postscript|../Images/expl.png|/2|/2||||>|Explanation of
  the TeXmacs window.>

  The <with|font shape|italic|title bar> displays the name of your text. In
  the above example, the text was not yet given a name.

  At the left and the right hand sides of the title bar you usually also see
  some <with|font shape|italic|window decorations>. These <with|font
  shape|italic|buttons> have some special effects when you click on them with
  the mouse. In the above example, they may for instance be used to minimize
  or to maximize the TeXmacs window, or to close down TeXmacs. In general,
  the window decorations depend on the <with|font shape|italic|window
  manager> you are using, a program which is independent from TeXmacs.

  Your text itself will be displayed in the <with|font shape|italic|canvas>.
  If the text does not fit into the window, then you may use the <with|font
  shape|italic|horizontal> and the <with|font shape|italic|vertical
  scrollbars> to scroll through the text and go to the particular piece that
  you want to edit. The <with|font shape|italic|caret> or <with|font
  shape|italic|cursor> indicates the particular position in the text where
  you are typing. You may move it by clicking on the left mouse button.

  The <with|font shape|italic|menus> on the <with|font shape|italic|menu bar>
  may be used to access special text editing facilities. For instance, the
  <with|font shape|italic|buffer menu> allows you to access to several texts
  which you may edit at the same time. For instance, the <with|font
  shape|italic|file menu> allows you to save and reload your texts and to
  print them out. The <with|font shape|italic|text menu> allows you to change
  the text font, the current language, and so on.

  The <with|font shape|italic|icons> on the <with|font shape|italic|icon
  bars> have a similar functionnality as the menus. Since there are more of
  them, they correspond to more specialized actions, which can easily be
  recognized from the graphical shape of the icon. Many icons are actually
  <with|font shape|italic|icon menus>, i.e. a <with|font shape|italic|popup
  menu> appears when you click on them.

  The lower <with|font shape|italic|status bar> or <with|font
  shape|italic|footer>, which is divided into a <with|font shape|italic|left>
  and a <with|font shape|italic|right footer>, displays some of the most
  relevant information concerning your text. In the above example, the left
  footer indicates that we are writing a letter in text mode, using a ten
  points roman character font. The right footer indicates that our cursor is
  located at the start of a paragraph.
</body>

<\initial>
  <\collection>
    <associate|paragraph width|150mm>
    <associate|odd page margin|30mm>
    <associate|shrinking factor|4>
    <associate|page right margin|30mm>
    <associate|page top margin|30mm>
    <associate|reduction page right margin|25mm>
    <associate|paragraph hyphenation|professional>
    <associate|reduction page bottom margin|15mm>
    <associate|page type|a4>
    <associate|reduction page left margin|25mm>
    <associate|even page margin|30mm>
    <associate|page bottom margin|30mm>
    <associate|reduction page top margin|15mm>
  </collection>
</initial>

<\references>
  <\collection>
    <associate|toc-1|<tuple|1|?>>
    <associate|toc-2|<tuple|1.1|?>>
    <associate|toc-3|<tuple|1.2|?>>
  </collection>
</references>

<\auxiliary>
  <\collection>
    <\associate|toc>
      <vspace*|1fn><with|font series|<quote|bold>|1 A first meeting with
      TeXmacs><value|toc-dots><pageref|toc-1><vspace|0.5fn>

      1.1 Starting TeXmacs up<value|toc-dots><pageref|toc-2>

      1.2 Understanding the TeXmacs window<value|toc-dots><pageref|toc-3>
    </associate>
  </collection>
</auxiliary>
