Новая справка по QSP.

“Пользовательские функции и процедуры”. Потому что пользовательская функция - это тоже подпрограмма.

Nex:

“Пользовательские функции и процедуры”

Переименовал.

“локации-функции” по сути те же “локации с кодом”, только могут работать, как функции. Почему не дать определение локации-подпрограммы:

Локации-подпрограммы - иногда удобно вынести часть кода в отдельную локацию. Чаще всего это код, который используется в нескольких локациях.

Далее можно дать определение локации-функции, как одной из разновидностей локаций-подпрограмм.
Тогда заголовок может быть таким “вызов локаций-подпрограмм” или “работа с подпрограммами”. Конечно тогда и в самом разделе нужно поставить оба определения.

Aleks Versus,
и тогда автору придётся запоминать три термина вместо двух. Нет, спасибо.

Nex:

Aleks Versus,
и тогда автору придётся запоминать три термина вместо двух. Нет, спасибо.

В принципе можно объединить “локации с кодом” и “локации-функции” в “локации-подпрограммы”, а ту статью переименовать в “Работа с подпрограммами”. Тогда вообще можно отказаться от термина “процедура”.

newsash,
опять двадцать пять?

Как различать процедуры и функции собираешься?

Nex:

опять двадцать пять?

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

Nex:

Как различать процедуры и функции собираешься?

А зачем их вообще различать (на уровне терминологии)? Если это различие практически стёрто даже в серьёзных языках программирования (например, “процедура - это функция, возвращающая значение типа void”), то движок текстовых игр тоже с этим справится.
По тексту описания операторов GOSUB и FUNC не используются термины “процедура” и “функция”, это излишне.

Вопрос только как будет понятнее людям - “процедура” и “функция” или два вида “подпрограмм”, один из которых возвращает значение.
Кстати, надо бы придумать альтернативу обороту “возвращает значение” для функций.

“процедура” и “функция” или два вида “подпрограмм”

“Процедура и функция” - это и есть два вида подпрограмм!

Угу, давайте вместо “джинсы” и “брюки” говорить “штаны из джинсовой ткани” и “штаны не из джинсовой ткани”. Так всем понятнее будет!

Nex:

Угу, давайте вместо “джинсы” и “брюки” говорить “штаны из джинсовой ткани” и “штаны не из джинсовой ткани”. Так всем понятнее будет!

Да, каждый дурак знает, что такое процедуры и функции настолько же хорошо, как знает, что такое джинсы и брюки. Особенно начинающие авторы, для которых это первое общение с программированием.
Различение по единственному функциональному различию гораздо понятнее непосвященному, чем терминологическое различение. Тем более функции от процедур отличаются, как мопед от велосипеда. Кстати, я знаю людей, которым “велосипед с моторчиком” понятнее, чем “мопед”.

P.S. Брюки из джинсовой ткани тоже бывают.

newsash,
ты пытаешься выдумать новую терминологию. Прекрати.

Особенно начинающие авторы, для которых это первое общение с программированием.

“Первое общение” у них будет не с теми задачами, для которых потребуется использовать процедуры и функции. “Первое общение” - это выполнение уроков, операторы ветвления, действия, переходы, предметы, переменные. До тех пор пока они не освоятся, у них и нужды не возникнет процедуры писать. Процедуры не нужны новичкам!

А нормальных программистов своей навязанной терминологией ты будешь только отпугивать. “Как у вас тут функцию сделать?” “Стоп, какую ещё функцию? Может ты имел в виду ПОДПРОГРАММУ ВОЗВРАЩАЮЩУЮ ЗНАЧЕНИЕ?”

Если тебе так охота сделать упор на “общую сущность” процедур и функций, обозначив что оба понятия относятся к подпрограммам, ты можешь всегда сделать это в учебных статьях. Там можно разжевать как хочешь подробно. Но портить ради этого справку нельзя.

В общем, у меня GS - обработка локации, FUNC - обработка локации с возвращением значения. Вводить в эти формулировки дополнительные термины я смысла не вижу. Поэтому речь идёт только о названии статьи и кусочке текста в статье про локации.
На данный момент в статье про локации есть “локации с кодом” и “локации-функции”, соответствующая статья называется “пользовательские функции и процедуры”. Причём слово “процедуры” по всей справке используется только в названии этой статьи.
Второй вариант, который был предложен:
Будут “локации-подпрограммы”, которые “могут как просто выполняться, так и возвращать значение” (формулировка обсуждаема). Статья будет называться “Работа с подпрограммами”.

Мне нужен трезвый рассудительный взгляд со стороны - как будет понятнее авторам без опыта программирования?

P.S. И есть желание заменить фразу “возвращает значение” на более понятную не программистам. Этот оборот многократно используется в справке.

UPD: По последнему сообщению: возможно, ты прав. Но необходимость в процедурах возникает как только автор перестаёт играться и осваиваться и хочет написать нормальную интересную игру.

>P.S. И есть желание заменить фразу “возвращает значение” на более понятную не программистам. Этот оборот многократно используется в справке.
Нужно на примере про показать что есть “возвращает значение”, чтобы стало понятно.

Flashback:

Нужно на примере про показать что есть “возвращает значение”, чтобы стало понятно.

Везде, где они не забыты, примеры есть.

Причём слово “процедуры” по всей справке используется только в названии этой статьи.

Только в заголовке, потому что должно быть нормальное описание в самой статье, которое раскрывает суть, зачем они нужны.

Зачем нужно делать процедуры, зачем нужны пользовательские функции. Кстати “предназначение подпрограмм” статей в инете завались, можно почти любую за основу взять. При этом заменить фразу “выделяется в отдельную подпрограмму” на “выделяется в отдельную локацию”.

Без этого объяснения статья почти бесполезна, каким заголовком её не обзови. А в объяснении всё равно придётся внятно делить подпрограммы по предназначению. Внятно обязательно, потому что по-другому информация не запомнится. Так что в итоге придётся либо вбивать в голову автора лишний термин “подпрограмма”, либо делать вид что “процедур” и “функций” не существует. И каждого новичка, который в учебнике или в обсуждении на форуме увидит слово “процедура” и спросит “что это, в справке этого нет”, я буду отправлять за разъяснениями к тебе лично.