Mercurial > octave-antonio
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 |