stikriz писал(а):в виндовозном инсталяторе лазаруса нет текстов для линукса
??? Не понял. Исходники никто не обрезает.
stikriz писал(а):что хелпа нету, и вообще доки никакой
Кто мешает начать писать его?
Глобальный путь к папке пользователя в Windows
Модератор: Модераторы
??? Не понял. Исходники никто не обрезает.
Кто мешает начать писать его?
-
Alexx2000
- постоялец
- Сообщения: 490
- Зарегистрирован: 25.10.2006 00:22:07
- Откуда: Мытищи
- Контактная информация:
stikriz писал(а):Потому, что хелпа нету, и вообще доки никакой.
Плохо искали:
Эта же информация есть в pdf документации, которая идет с FPC.
А функции GetAppConfigDirUTF8 и GetAppConfigFileUTF8 (как и все остальные с окончанием *UTF8), делают тоже самое, только для строк в кодировке UTF-8
Alexx2000 писал(а):stikriz писал(а):Потому, что хелпа нету, и вообще доки никакой.
Плохо искали:
Эта же информация есть в pdf документации, которая идет с FPC.
А функции GetAppConfigDirUTF8 и GetAppConfigFileUTF8 (как и все остальные с окончанием *UTF8), делают тоже самое, только для строк в кодировке UTF-8
Это образец как не нужно писать доку. В первом случае нафига указан inc? Во втором вообще нет какой именно модуль нужно подключить. И дока вся не структуированая. Видно, что делали её по исходникам.
-
Brainenjii
- энтузиаст
- Сообщения: 1351
- Зарегистрирован: 10.05.2007 00:04:46
В первом случае нафига указан inc?
Чтоб знать, где искать.
Во втором вообще нет какой именно модуль нужно подключить.
как нет? Этот модуль в пути к странице - http://www.freepascal.org/docs-html/rtl/sysutils/getappconfigfile.html
И дока вся не структуированая. Видно, что делали её по исходникам.
А что, появился иной адекватный способ формирования доки? 0.о
Brainenjii писал(а):А что, появился иной адекватный способ формирования доки?
Всю жисть был
Разбить функции по функционалу на группы.Brainenjii писал(а):как нет? Этот модуль в пути к странице - http://www.freepascal.org/docs-html/rtl ... gfile.html
Этот модуль должен быть указан не в пути странице,Э а на странице там, где идет описание. Там и место есть специальное.
Brainenjii писал(а):Чтоб знать, где искать.
Нужно знать какой модуль подключать.
Был задан вопрос - был дан исчерпывающий ответ. В чем Вы видите пользу от ерничания на тему, мол, ах обижают наш freepascal?
А для кого написано в правом верхнем углу страницы http://www.freepascal.org/docs-html/rtl/sysutils/getappconfigfile.html
Reference for unit 'sysutils' (#rtl) ?
Reference for unit 'sysutils' (#rtl) ?
stikriz писал(а):Это образец как не нужно писать доку.
Это вы еще документацию на Lazarus не изучали.
По сравнению с нею, это отлично документированная функция. А так то традиции подразумевают перечислить саму функцию и аргументы оной, без каких либо указаний, зачем и для чего они.
-
alexs
- долгожитель
- Сообщения: 4069
- Зарегистрирован: 15.05.2005 23:17:07
- Откуда: г.Ставрополь
- Контактная информация:
stikriz писал(а):Этот модуль должен быть указан не в пути странице,Э а на странице там, где идет описание. Там и место есть специальное.
Внимательно изучаем верхний правый угол:
Reference for unit 'sysutils' (#rtl)
stikriz писал(а):И дока вся не структуированая.
- для кого?See also
stikriz писал(а): Видно, что делали её по исходникам.
1. Быстрый вариант написания документации есть другой?
2. Вместо критики - присоеденяемся к команде и пишем доку.
3. НЕ ЛЕНИМСЯ ЗАГЛЯДЫВАТЬ В ИСХОДНЫЕ ТЕКСТЫ!!!!