Changed russian description a little bit
[gnuplot] / README
1
2 The Gnuplot Plotting Utility
3 ****************************
4
5 Gnuplot is a command-line driven interactive function plotting utility
6 for UNIX, MSDOS, VMS, and many other platforms.  The software is copyrighted
7 but freely distributed (i.e., you don't have to pay for it).  It was
8 originally intended as graphical program which would allow scientists
9 and students to visualize mathematical functions and data.  Gnuplot
10 supports many different types of terminals, plotters, and printers
11 (including many color devices, and pseudo-devices like LaTeX) and is
12 easily extensible to include new devices.  [ The "GNU" in gnuplot is
13 NOT related to the Free Software Foundation, the naming is just a
14 coincidence (and a long story; see the gnuplot FAQ for details). Thus
15 gnuplot is not covered by the GNU copyleft, but rather by its own
16 copyright statement, included in all source code files.]
17
18 Gnuplot handles both curves (2 dimensions) and surfaces (3
19 dimensions). Surfaces can be plotted as a mesh fitting the specified
20 function, floating in the 3-d coordinate space, or as a contour plot
21 on the x-y plane. For 2-d plots, there are also many plot styles,
22 including lines, points, lines with points, error bars, impulses and
23 (optionally filled) boxes.  Graphs may be labeled with arbitrary
24 labels and arrows, axis labels, a title, date and time, and a key.
25 The interface includes command-line editing and history on most
26 platforms.
27
28 The new gnuplot user should begin by reading the general information
29 available by typing `help` after running gnuplot. Then read about the
30 `plot` command (type `help plot`).  The manual for gnuplot (which is a
31 nicely formatted version of the on-line help information) can be
32 printed either with TeX, troff or nroff.  Look at the docs/Makefile
33 for the appropriate option.
34
35  The gnuplot source code and executables may be copied and/or modified
36 freely as long as the copyright messages are left intact.
37
38 Copyright and Porting
39 =====================
40
41  See the Copyright file for copyright conditions.
42
43  See the ChangeLog and docs/old/History.old file for changes to gnuplot.
44
45  Build instructions are in the INSTALL file.  Some additional
46 informations needed to port gnuplot to new platforms not covered by
47 GNU autoconf can be found in the PORTING file. 
48
49  The code for gnuplot was written with portability in mind; however, the
50 new features incorporated from v3.7 on were developed with ANSI-C compliant
51 compilers, and it was deemed expedient to restrict the development effort
52 to that environment, with the consequence that systems that could build
53 previous gnuplot releases may require some source modifications.  gnuplot
54 has been tested on the following systems (incomplete), but be aware that
55 this list is not necessarily up to date with regard to the current version
56 of gnuplot:
57
58  o Sun3, sun4c, sun4m, sun4u (SunOS 4.03, SunOS 4.1.x, Solaris 2.5.1/2.6/2.7)
59  o uVAX 3100 (VMS 5.4, 5.5, 6.0, 6.1)
60  o VAX 6410 (VMS 5.2)
61  o DECStation 5000/200PXG (ULTRIX V4.1)
62  o DEC AXP 3400 (VMS/OpenVMS 1.5, 6.2)
63  o DEC AXP 600, A1000A, 3000 (DEC Unix 3.2 4.0, Windows NT 4.0 MSVC++ 4.0)
64  o IBM PC and compatibles (MS-DOS 3.3/5.0 32-bit DJGPP,
65    OS/2 2.x, Linux 2.x SVGA X11, Windows 9x, ME, Windows NT, 2K, XP)
66  o IBM AIX 3.x and 4.x
67  o CBM Amiga (AmigaOS 1.3, 2.x and 3.x, SAS/C 6.2 and better, Aztec C
68    beta 5.2a, gcc; Linux 2.x, NetBSD-1.3.x)
69  o IRIS 4D/70G and 4D/25G with MIPS C
70  o NeXT with gnu C 1.34
71  o AT&T 3B1 (version 3.51m with cc and gcc 1.39)
72  o Apollo's (DomainOS SR10.3 BSD4.3 with C compiler 68K Rev 6.7(316))
73  o HP 300 (m68k) and HP 700 (PA-RISC) (HP-UX 9.x 10.x)
74  o SGI Challenge and O2 (Irix 6.2, 6.3)
75
76  gnuplot has not been tested on Pyramid 90x.  You can expect that gnuplot
77 will compile more or less out of the box on any system which has a newer
78 (2.x) version of the GNU C compiler gcc, or is compliant with current
79 POSIX/Unix standards.
80
81
82 Help and Bug Reports
83 ********************
84
85  Your primary place to go searching for help with gnuplot should
86 be the project's webpage.  At the time of this writing, that's
87
88         http://gnuplot.sourceforge.net
89
90  It has links to a lot of material, including the project's development
91 page, also at SourceForge:
92
93         http://sourceforge.net/projects/gnuplot/
94
95  Note that since gnuplot has nothing to do with the GNU project, please
96 don't ask them for help or information about gnuplot; also, please
97 don't ask us about GNU stuff.
98
99  Please note that all bug reports should include the machine you are
100 using, the operating system and it's version, plotting devices, and
101 the version of gnuplot that you are running.  If you could add such
102 information to any messages on the Usenet newsgroup or the other
103 mailing lists and trackers, that'd be nice, too.
104
105  
106 Usenet
107 ======
108
109  Additional help can be obtained from the USENET newsgroup
110
111         comp.graphics.apps.gnuplot.
112
113  This newsgroup is the first place to ask for routine help.  It used to be
114 gatewayed bi-directionally to the info-gnuplot mailing list, but that
115 had to be stopped when we moved the mailing lists off Dartmouth.
116
117
118 Mailing Lists
119 =============
120
121  As of gnuplot-4.0, the gnuplot mailing lists have moved away from
122 their old home at Dartmouth College (thanks, guys!) to the project's
123 general new development site provided by SourceForge.net.  To 
124 subscribe to these new mailing lists, use the Web Interface provided
125 by SourceForge.net:
126         
127         http://sourceforge.net/mail/?group_id=2055
128
129  The main lists you may be interested in are "gnuplot-info" and 
130 "gnuplot-bugs".  "gnuplot-info" is for general discussion and
131 questions about how to use the program.  But as noted above,
132 using the Usenet newsgroup for this kind of communication is 
133 almost certainly better both for you and for us.
134
135  "gnuplot-bugs" is NOT an appropriate place to ask questions on how to
136 solve a gnuplot problem or even to report a bug that you haven't
137 investigated personally.  It is far more likely you'll get the help
138 you need for this kind of problem from comp.graphics.apps.gnuplot
139 or the gnuplot-info mailing list.
140
141  Using "gnuplot-bugs" is also slightly disfavoured, because it makes it
142 hard for us to keep track what bugs are currently under investigation,
143 and hard for you to check if maybe the bug you've found has already
144 been reported by somebody else before.  We would thus like to ask to
145 you please use the "Bug Tracker" system that is part of gnuplot's
146 development web site at SourceForge.net instead of this mailing list.
147
148  If you found a fix already, pleast post it in "diff -c" or "diff -u"
149 format done against the most current official version of gnuplot or
150 the latest alpha or beta release of the next version.  All major
151 modifications should include documentation and, if new features were
152 added, a demo file.  Finally, it is much easier to integrate smaller
153 stepwise modifications rather than one gigantic diff file which
154 represented months of changes.  
155
156  There are separate tracking systems for Feature Requests and proposed
157 patches that implement new features, also hosted at SourceForge.  
158
159  Discussions about plans for new features or other significant changes
160 should be announced and discussed on the developers' mailing list,
161 gnuplot-beta, which is also hosted by SourceForge.net.
162
163
164 Where to get updates to gnuplot
165 ===============================
166
167  Congratulations on getting this version of gnuplot! Unfortunately, it
168 may not be the most recent version ("you never know where this version
169 has been!"). You can be sure that it IS the most recent version by
170 checking one of the official distribution sites, guaranteed to be kept
171 up to date (of course, if you got this file from one of those sites,
172 you don't need to check!).
173
174  To hear automatically about future releases (and other gnuplot news),
175 read the newsgroup; see above.
176
177 Distribution sites
178 ******************
179
180  In general, gnuplot 4.0 is available as the file gnuplot-4.0.0.tar.gz.
181 Because of the numerous changes since version 3.7, no patch files will
182 be available to bring 3.7 to 4.0.  It will be made available at web
183 and ftp sites listed below, along with DOS (32-bit, 386 or higher)
184 Windows (32-bit, i.e. the 9x and NT families) and OS/2 2.0
185 executables.  Amiga binaries will be made available on Aminet.
186 Macintosh binaries are planned to appear on the official gnuplot sites
187 at a later time.
188
189  Also, some sites will have a special documentation tarball which
190 contains PostScript and other versions of the manuals and tutorials
191 for printout or installation in your system.
192
193 Please obtain gnuplot from the site nearest to you.
194
195 NORTH AMERICA:
196
197      Anonymous ftp to ftp.gnuplot.vt.edu:
198      ftp://ftp.gnuplot.vt.edu/pub/gnuplot/gnuplot-4.0.0.tar.gz
199      ftp://ftp.gnuplot.info/pub/gnuplot/gnuplot-4.0.0.tar.gz
200
201      Alternatively, you can use your web browser to get gnuplot
202      from the gnuplot web pages at 
203      http://sourceforge.net/projects/gnuplot/files
204
205      Anonymous ftp to ftp.dartmouth.edu. Please try the
206      other sites first!
207      ftp://ftp.dartmouth.edu/pub/gnuplot/gnuplot-4.0.0.tar.gz
208
209 AUSTRALIA:
210
211      From the AARNet Mirror Project:
212      ftp://mirror.aarnet.edu.au/pub/gnuplot/
213      http://mirror.aarnet.edu.au/pub/gnuplot/
214
215      Anonymous ftp to ftp.cc.monash.edu.au:
216      ftp://ftp.cc.monash.edu.au/pub/gnuplot/gnuplot-4.0.0.tar.gz
217
218
219 EUROPE:
220
221      Anonymous ftp to ftp.irisa.fr:
222      ftp://ftp.irisa.fr/pub/gnuplot/gnuplot-4.0.0.tar.gz
223
224      Anonymous ftp to ftp.ucc.ie:
225      ftp://ftp.ucc.ie/pub/gnuplot/gnuplot-4.0.0.tar.gz
226
227 OTHER:
228
229      The CTAN mirror network has gnuplot in its "graphics" area
230      http://www.ctan.org/
231
232      Source and binary distributions for the Amiga are on Aminet in
233      http://ftp.wustl.edu/~aminet/gfx/misc/ and its mirrors.
234
235 ----
236
237                                         -Thomas Williams-
238                                         -Alex Woo-
239                                         -David Denholm-
240                                         -Lars Hecking-