comparison doc/interpreter/bugs.txi @ 10791:3140cb7a05a1

Add spellchecker scripts for Octave and run spellcheck of documentation interpreter/doccheck: New directory for spelling/grammar scripts. interpreter/doccheck/README: Instructions for using scripts. interpreter/doccheck/spellcheck: Script to spellcheck a Texinfo file. interpreter/doccheck/aspell.conf: GNU Aspell configuration file for Octave documentation. interpreter/doccheck/aspell-octave.en.pws: Private Aspell dictionary. interpreter/doccheck/add_to_aspell_dict: Script to add new Octave-specific words to private Aspell dictionary. interpreter/octave.texi: New @nospell macro which forces Aspell to ignore the word marked by the macro. interpreter/mk_doc_cache.m: Skip new @nospell macro when building doc_cache.
author Rik <octave@nomad.inbox5.com>
date Sat, 17 Jul 2010 19:53:01 -0700
parents a9677b03632b
children d682cd6669ac
comparison
equal deleted inserted replaced
10790:01f1643dfbb1 10791:3140cb7a05a1
268 one can't miss it. But if the bug is incorrect output, we might not 268 one can't miss it. But if the bug is incorrect output, we might not
269 notice unless it is glaringly wrong. 269 notice unless it is glaringly wrong.
270 270
271 Even if the problem you experience is a fatal signal, you should still 271 Even if the problem you experience is a fatal signal, you should still
272 say so explicitly. Suppose something strange is going on, such as, your 272 say so explicitly. Suppose something strange is going on, such as, your
273 copy of the interpreter is out of synch, or you have encountered a bug 273 copy of the interpreter is out of sync, or you have encountered a bug
274 in the C library on your system. Your copy might crash and the copy 274 in the C library on your system. Your copy might crash and the copy
275 here would not. If you said to expect a crash, then when the 275 here would not. If you said to expect a crash, then when the
276 interpreter here fails to crash, we would know that the bug was not 276 interpreter here fails to crash, we would know that the bug was not
277 happening. If you don't say to expect a crash, then we would not know 277 happening. If you don't say to expect a crash, then we would not know
278 whether the bug was happening. We would not be able to draw any 278 whether the bug was happening. We would not be able to draw any
357 install them both. We might want to install just one. 357 install them both. We might want to install just one.
358 358
359 @item 359 @item
360 Use @samp{diff -c} to make your diffs. Diffs without context are hard 360 Use @samp{diff -c} to make your diffs. Diffs without context are hard
361 for us to install reliably. More than that, they make it hard for us to 361 for us to install reliably. More than that, they make it hard for us to
362 study the diffs to decide whether we want to install them. Unidiff 362 study the diffs to decide whether we want to install them. Unified diff
363 format is better than contextless diffs, but not as easy to read as 363 format is better than contextless diffs, but not as easy to read as
364 @samp{-c} format. 364 @samp{-c} format.
365 365
366 If you have GNU diff, use @samp{diff -cp}, which shows the name of the 366 If you have GNU diff, use @samp{diff -cp}, which shows the name of the
367 function that each change occurs in. 367 function that each change occurs in.
390 @cindex help, where to find 390 @cindex help, where to find
391 391
392 The mailing list @email{help@@octave.org} exists for the discussion of 392 The mailing list @email{help@@octave.org} exists for the discussion of
393 matters related to using and installing Octave. If would like to join 393 matters related to using and installing Octave. If would like to join
394 the discussion, please send a short note to 394 the discussion, please send a short note to
395 @email{help@strong{-request}@@octave.org}. 395 @email{help-request@@octave.org}.
396 396
397 @strong{Please do not} send requests to be added or removed from the 397 @strong{Please do not} send requests to be added or removed from the
398 mailing list, or other administrative trivia to the list itself. 398 mailing list, or other administrative trivia to the list itself.
399 399
400 If you think you have found a bug in Octave or in the installation 400 If you think you have found a bug in Octave or in the installation