Моделирование в системе MATLAB. Часть 1. Основы работы в MATLAB. Терёхин В.В. - 63 стр.

         Каждая функция в системе MATLAB содержит строку опре-
деления функции, подобную приведенной. Если функция имеет более
одного выходного аргумента, список выходных аргументов помеща-
ется в квадратные скобки. Входные аргументы, если они присутству-
ют, помещаются в круглые скобки. Для отделения аргументов во
входном и выходном списках применяются запятые.
         Пример
     function [x, y, z] = sphere(theta, phi, rho)

        Имена входных переменных могут, но не обязаны совпадать с
именами, указанными в строке определения функции.
        Первая строка комментария. Для функции average первая
строка комментария выглядит так:
        % AVERAGE Среднее значение элементов вектора
        Это - первая строка текста, которая появляется, когда пользо-
ватель набирает команду help <имя_функции>. Кроме того, первая
строка комментария выводится на экран по команде поиска lookfor.
Поскольку эта строка содержит важную информацию об M-файле, она
должна быть тщательно составлена.
        Комментарий. Для M-файлов можно создать online-
подсказку, вводя текст в одной или более строках комментария.
        Пример. Сформируем несколько строк комментария:
        % Функция average(x) вычисляет среднее значение эле-
ментов вектора x
        % Если входной аргумент не является вектором, выдается
ошибка

        Тогда при вводе команды подсказки help <имя_функции>,
система MATLAB отображает строки комментария, которые разме-
щаются между строкой определения функции и первой пустой стро-
кой, либо началом программы. Команда help <имя_функции> игнори-
рует комментарии, размещенные вне этой области.
        Пример.
     help sin
     SIN Sine.
        SIN(X) is the sine of the elements of X
        SIN(X) вычисляет функцию синуса элементов массива X

        Оглавление каталога. Можно создать комментарий для це-
лого каталога, если сформировать специальный файл с именем
Contents.m. Этот файл должен содержать только строки комментари-
ев. MATLAB выводит на экран строки файла Contents.m по команде

                                                                  61