ALT Linux Bugzilla – #17388

Вообще говоря, об этом мы писали в первой главе. Но наверное, перед листингом, стоило добавить предложение о том, что текст функции надо набрать в текстовом редакторе и сохранить по именем cub.sce.

Принято, добавим текст.

Такой текст есть, он прямо предшествет рассматриваемому примеру. 

стр. 24: "Вообще говоря, функции в Scilab играют роль подпрограмм. Поэтому
целесообразно набирать их тексты в редакторе и сохранять в виде
отдельных файлов. Причем имя файла должно обязательно совпадать с
именем функции. Расширение файлам-функциям обычно присваивают sci или
sce."

Может быть, перед листингом 2.17 словосочетание "список команд" следует заменить на "текст функции", чтобы было понятнее, о чем речь?

Тогда листинг 2.17 следует разбить на два: первый обозвать "Исходный код функции cub.sce", а второй - "Вызов функции и вывод результатов ее работы"

(In reply to comment #3)
> Такой текст есть, он прямо предшествет рассматриваемому примеру. 
> 
> стр. 24: "Вообще говоря, функции в Scilab играют роль подпрограмм. Поэтому
> целесообразно набирать их тексты в редакторе и сохранять в виде
> отдельных файлов. Причем имя файла должно обязательно совпадать с
> именем функции. Расширение файлам-функциям обычно присваивают sci или
> sce."
> 
> Может быть, перед листингом 2.17 словосочетание "список команд" следует
> заменить на "текст функции", чтобы было понятнее, о чем речь?
> 
Да, наверное так будет лучше. Мне вообще казалось, что из текста на стр.24 понятно, как набирать текст. Но, если читателю непонятно, то давайте заменим  "список команд" на "текст функции" 

(In reply to comment #4)
> Тогда листинг 2.17 следует разбить на два: первый обозвать "Исходный код
> функции cub.sce", а второй - "Вызов функции и вывод результатов ее работы"
> 
Не вижу в этом необходимоси

(In reply to comment #6)

> Не вижу в этом необходимоси
> 
Иначе непонятно, что 
(а) действие происходит в двух разных окнах и 
(б) в каком именно месте следует сохранить файл.

Предлагаю в начале листинга перед текстом функции поместить комментарий: 
//файл cub.sce
function [x1,x2,x3]=cub(a,b,c,d)
[...]

Кажется, так уже гораздо нагляднее и при этот не требуются многословные
пояснения.

исправлено в электронном выпуске:
http://docs.altlinux.org/books/2008/altlibrary-scilab-20090409.pdf