Debian Codegraph @

README

raw
1 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2
3 MagicPoint - an X11 based presentation tool
4
5 September 9, 2003
6
7 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
8
9 MagicPoint is an X11 based presentation tool. It is designed to make
10 simple presentations easy while to make complicated presentations
11 possible. Its presentation file (whose suffix is typically .mgp) is
12 just text so that you can create presentation files quickly with your
13 favorite editor (e.g. Emacs).
14
15 This is one of the alpha releases of MagicPoint. We're planing to add
16 a version control mechanism of .mgp file for forward compatibly. But
17 currently, such a mechanism is missing. Please use this package at
18 your own risk.
19
20 MagicPoint is completely free but absolutely no warranty. For more
21 information, please refer to COPYRIGHT or COPYRIGHT.jp. Please note
22 that some of the source codes is derived from other people's works,
23 and may have different distribution policies. Be sure to check the
24 comments in the source codes.
25
26
27 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
28
29 INSTALLATION
30
31 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
32
33 Since MagicPoint extensively uses fonts in various sizes, we recommend
34 you to install good font rendering systems in your system.
35
36 THIS DOCUMENT ASSUMES THAT YOU WILL USE MAGICPOINT WITH **TRUETYPE**
37 FONTS. YOU SHOULD INSTALL *FREETYPE* BEFORE YOU INSTALL MAGICPOINT.
38
39 To install "libttf.a", see:
40 http://www.freetype.org/
41
42 If you want to use other rendering systems, read "README.fonts" or
43 "README.fonts.jp".
44
45 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
46
47 Follow the steps below to make MagicPoint:
48
49 English or European:
50 % ./configure
51
52 Japanese:
53 % ./configure --enable-freetype-charset16
54
55 % xmkmf
56 % make Makefiles
57 % make
58
59 Invoking `configure' updates Imakefile. So, do NOT forget to invoke
60 `xmkmf' everytime you update Imakefile.
61
62 Note: if you have to use a non-standard compiler, you must declare
63 your compiler by using "env" command, like:
64
65 % env CC=gcc ./configure # force gcc
66 % env CC=shlicc2 ./configure # force shlicc2 (bsdi3)
67
68 We cannot make a guess in the configure script, since "imake"
69 may dislike the compiler that was guessed by configure. This
70 applies to, for example, Solaris without the Sun compiler
71 license (gcc-only environment).
72
73
74 Note 1: If you are willing to use the iso-8859-x character set (i.e. you
75 would like setlocale() to be called at startup), specify the
76 "--enable-locale" option.
77
78 Note 2: If you have libraries installed at odd places, use the option
79 --with-searchpath=/your/odd/path. E.g. if you have installed libfreetype
80 on MAcOS X from Fink, use ./configure --with-searchpath=/sw
81 Multiple directories need to be included in quotes and seperated with
82 spaces.
83
84 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
85
86 It's a good idea to preview sample files before installation. For more
87 information, see "sample/README" or "sample/README.jp", which
88 describes how to install TrueType fonts.
89
90 To visualize the sample{,-jp}.mgp file, type:
91
92 % ./mgp sample/sample.mgp
93 % ./mgp sample/sample-jp.mgp
94
95 To visualize the tutorial{,-jp}.mgp file, type:
96
97 % ./mgp sample/tutorial.mgp
98 % ./mgp sample/tutorial-jp.mgp
99
100 WE STRONGLY RECOMMEND TO BUY TRUETYPE FONTS IF YOU WANT TO GIVE YOUR
101 PRESENTATION WITH BEAUTIFUL FONTS.
102
103 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
104
105 When you believe that everything is OK, install MagicPoint as follows:
106
107 % su
108 # make install
109 # make install.man
110
111 Alternatively you can build a native package (RPM, DEB, PKG, ...) for
112 your operating system with the EPM package manager (freely available
113 from http://www.easysw.com/epm/) and install this package. The configu-
114 ration file for the packages is "mgp.list".
115
116 The EPM method has the advantage that you can uninstall magicpoint later
117 if you no longer need it or want to upgarde to a new version. The following
118 commands for instance generate a Debian package and a RPM package on linux
119 systems:
120
121 % su # necessary on Debian only
122 $ epm -f deb -nm mgp # creates DEB in subdirectory linux-*/
123 $ epm -f rpm -nm mgp # creates RPM in subdirectory linux-*/
124
125 If you want to paste EPS figures into your presentation, you will need
126 to install "ghostscript" or "alike".
127
128 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
129
130 FOR MORE INFO
131
132 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
133
134 Official home page of MagicPoint is:
135 http://member.wide.ad.jp/wg/mgp/
136
137 Stable release packages are available from:
138 ftp://sh.wide.ad.jp/WIDE/free-ware/mgp/
139
140 To join the mailing-list for MagicPoint, See:
141 http://member.wide.ad.jp/wg/mgp/ml.html
142 http://member.wide.ad.jp/wg/mgp/ml-jp.html (in Japanese)
143 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%