~ubuntu-branches/ubuntu/hardy/texmacs/hardy

« back to all changes in this revision

Viewing changes to TeXmacs/doc/devel/plugin/plugin-install.en.tm

  • Committer: Bazaar Package Importer
  • Author(s): Ralf Treinen
  • Date: 2004-04-19 20:34:00 UTC
  • Revision ID: james.westby@ubuntu.com-20040419203400-g4e34ih0315wcn8v
Tags: upstream-1.0.3-R2
ImportĀ upstreamĀ versionĀ 1.0.3-R2

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<TeXmacs|1.0.1.21>
 
2
 
 
3
<style|tmdoc>
 
4
 
 
5
<\body>
 
6
  <expand|tmdoc-title|Installing and using a plugin>
 
7
 
 
8
  From the user's point of view, a plugin <verbatim|<em|myplugin>> will
 
9
  usually be distributed on some web-site as a binary tarball with the name
 
10
 
 
11
  <\verbatim>
 
12
    \ \ \ \ <em|myplugin>-<em|version>-<em|architecture>.tar.gz
 
13
  </verbatim>
 
14
 
 
15
  If you installed <TeXmacs> yourself in the directory
 
16
  <verbatim|$TEXMACS_PATH>, then you should unpack this tarball in the
 
17
  directory <verbatim|$TEXMACS_PATH/plugins>, using
 
18
 
 
19
  <\verbatim>
 
20
    \ \ \ \ tar -zxvf <em|myplugin>-<em|version>-<em|architecture>.tar.gz
 
21
  </verbatim>
 
22
 
 
23
  This will create a <verbatim|<em|myplugin>> subdirectory in
 
24
  <verbatim|$TEXMACS_PATH/plugins>. As soon as you restart <TeXmacs>, the
 
25
  plugin should be automatically recognized. Please read the documentation
 
26
  which comes with your plugin in order to learn using it.
 
27
 
 
28
  <\remark>
 
29
    If you did not install <TeXmacs> yourself, or if you do not have write
 
30
    access to <verbatim|$TEXMACS_PATH>, then you may also unpack the tarball
 
31
    in <verbatim|$TEXMACS_HOME_PATH/plugins>. Here we recall that
 
32
    <verbatim|$TEXMACS_HOME_PATH> defaults to <verbatim|$HOME/.TeXmacs>. When
 
33
    starting <TeXmacs>, your plugin should again be automatically recognized.
 
34
  </remark>
 
35
 
 
36
  <\remark>
 
37
    If the plugin is distributed as a source tarball like
 
38
    <verbatim|<em|myplugin>-<em|version>-src.tar.gz>, then you should first
 
39
    compile the source code before relaunching <TeXmacs>. Depending on the
 
40
    plugin (read the instructions), this is usually done using
 
41
 
 
42
    <\verbatim>
 
43
      \ \ \ \ cd <em|myplugin>; make
 
44
    </verbatim>
 
45
 
 
46
    or
 
47
 
 
48
    <\verbatim>
 
49
      \ \ \ \ cd <em|myplugin>; ./configure; make
 
50
    </verbatim>
 
51
  </remark>
 
52
 
 
53
  <\remark>
 
54
    In order to upgrade a plugin, just remove the old version in
 
55
    <verbatim|$TEXMACS_PATH/plugins> or <verbatim|$TEXMACS_HOME_PATH/plugins>
 
56
    using
 
57
 
 
58
    <\verbatim>
 
59
      \ \ \ \ rm -rf <em|myplugin>
 
60
    </verbatim>
 
61
 
 
62
    and reinstall as explained above.
 
63
  </remark>
 
64
 
 
65
  <apply|tmdoc-copyright|1998--2002|Joris van der Hoeven>
 
66
 
 
67
  <expand|tmdoc-license|Permission is granted to copy, distribute and/or
 
68
  modify this document under the terms of the GNU Free Documentation License,
 
69
  Version 1.1 or any later version published by the Free Software Foundation;
 
70
  with no Invariant Sections, with no Front-Cover Texts, and with no
 
71
  Back-Cover Texts. A copy of the license is included in the section entitled
 
72
  "GNU Free Documentation License".>
 
73
</body>
 
74
 
 
75
<\initial>
 
76
  <\collection>
 
77
    <associate|paragraph width|150mm>
 
78
    <associate|odd page margin|30mm>
 
79
    <associate|shrinking factor|4>
 
80
    <associate|page right margin|30mm>
 
81
    <associate|page top margin|30mm>
 
82
    <associate|reduction page right margin|25mm>
 
83
    <associate|page type|a4>
 
84
    <associate|reduction page bottom margin|15mm>
 
85
    <associate|even page margin|30mm>
 
86
    <associate|reduction page left margin|25mm>
 
87
    <associate|page bottom margin|30mm>
 
88
    <associate|reduction page top margin|15mm>
 
89
    <associate|language|english>
 
90
  </collection>
 
91
</initial>
 
92
 
 
93
<\references>
 
94
  <\collection>
 
95
    <associate|idx-1|<tuple|<uninit>|?>>
 
96
    <associate|toc-1|<tuple|<uninit>|?>>
 
97
    <associate|idx-2|<tuple|<uninit>|?>>
 
98
    <associate|toc-2|<tuple|<uninit>|?>>
 
99
  </collection>
 
100
</references>