Bug 17388

Summary: Листинг 2.17. Решение кубического уравнения
Product: scilab Reporter: Vyatcheslav Perevalov <vip0>
Component: miscAssignee: kirill <kirill>
Status: CLOSED FIXED QA Contact: kirill <kirill>
Severity: normal    
Priority: P2 CC: EAlekseev, bertis
Version: не указана   
Hardware: all   
OS: Linux   

Description Vyatcheslav Perevalov 2008-09-29 20:21:10 MSD
Листинг 2.17. Решение кубического уравнения
Не указано, что текст необходимо вводить в редакторе (кнопка Editor)
Comment 1 aer 2008-10-01 14:46:59 MSD
Вообще говоря, об этом мы писали в первой главе. Но наверное, перед листингом, стоило добавить предложение о том, что текст функции надо набрать в текстовом редакторе и сохранить по именем cub.sce.
Comment 2 kirill 2008-10-01 15:08:19 MSD
Принято, добавим текст.
Comment 3 Vladimir Zhukov 2008-10-01 16:58:16 MSD
Такой текст есть, он прямо предшествет рассматриваемому примеру. 

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

Может быть, перед листингом 2.17 словосочетание "список команд" следует заменить на "текст функции", чтобы было понятнее, о чем речь?
Comment 4 Vyatcheslav Perevalov 2008-10-01 17:11:00 MSD
Тогда листинг 2.17 следует разбить на два: первый обозвать "Исходный код функции cub.sce", а второй - "Вызов функции и вывод результатов ее работы"
Comment 5 aer 2008-10-01 17:51:36 MSD
(In reply to comment #3)
> Такой текст есть, он прямо предшествет рассматриваемому примеру. 
> 
> стр. 24: "Вообще говоря, функции в Scilab играют роль подпрограмм. Поэтому
> целесообразно набирать их тексты в редакторе и сохранять в виде
> отдельных файлов. Причем имя файла должно обязательно совпадать с
> именем функции. Расширение файлам-функциям обычно присваивают sci или
> sce."
> 
> Может быть, перед листингом 2.17 словосочетание "список команд" следует
> заменить на "текст функции", чтобы было понятнее, о чем речь?
> 
Да, наверное так будет лучше. Мне вообще казалось, что из текста на стр.24 понятно, как набирать текст. Но, если читателю непонятно, то давайте заменим  "список команд" на "текст функции" 
Comment 6 aer 2008-10-01 17:52:36 MSD
(In reply to comment #4)
> Тогда листинг 2.17 следует разбить на два: первый обозвать "Исходный код
> функции cub.sce", а второй - "Вызов функции и вывод результатов ее работы"
> 
Не вижу в этом необходимоси
Comment 7 Vyatcheslav Perevalov 2008-10-01 18:03:05 MSD
(In reply to comment #6)

> Не вижу в этом необходимоси
> 
Иначе непонятно, что 
(а) действие происходит в двух разных окнах и 
(б) в каком именно месте следует сохранить файл.
Comment 8 kirill 2009-04-08 14:49:34 MSD
Предлагаю в начале листинга перед текстом функции поместить комментарий: 
//файл cub.sce
function [x1,x2,x3]=cub(a,b,c,d)
[...]

Кажется, так уже гораздо нагляднее и при этот не требуются многословные
пояснения.
Comment 9 kirill 2009-04-09 16:10:28 MSD
исправлено в электронном выпуске:
http://docs.altlinux.org/books/2008/altlibrary-scilab-20090409.pdf