freepascal.ru

Alexander писал(а):

debi12345 писал(а): На запись - не умею.

al_exus писал(а):Не, пусть как все - пользователем, заодно добавит что знает, а то админом будет только руководить

А ты всерьёз за МСЕ взялся ?

Alexander, этот вопрос мне?
Я пишу на фоксе, MSEIDE изучаю "факультативно", дома, просто есть ощущение серьезности проекта. Хочется убедиться и, возможно, в дальнейшем использовать как альтернативу Фоксу. Пока что, для пробы, сделал парочку небольших программ (конвертор проводок для экспорта в систему SAP R/3 и вьювер-телефонный справочник города). Сейчас взялся за третью, в плане структуры - чуть посерьезнее двух первых, пока на стадии набивания шишек по каждому поводу.

Майонез - это драйвер для борща.

А перевести это Мартину стоило. Ему же интересно.

зафлудили ветку =) пусть про моенез все прочитают, и я её прорежу.

al_exus, а тебе доступ к SVN нужен ?

О ! А в проекте документирования произошли подвижки !

debi12345, спасибо !

Я ничего и не делал
Это нас европейцы на буксир взяли (как всегда). А мы все идеалы ищем да щеки надуваем.
Человек стал выкладывать в примеры все мелкие тестовые проекты, по которым изучает библитеку. Умница, правда ?

Alexander писал(а):al_exus, а тебе доступ к SVN нужен ?

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

al_exus писал(а):В будущем

Когда захочешь, создай аккаунт на sourceforge.net и
запомни пароль. Логин сообщи, я его зарегю.

al_exus писал(а): пока осознание еще не пришло, тыкаюсь практически вслепую и при каждом шаге получаю шваброй в лоб.

Я тоже.

Кто нибудь запускал скрипты автодокументирования в последнее
время ? А то я или забыл, что на что в .ini файлах менять или древо
FPC изменилось по структуре. Второй вариант вероятнее.

Для МСЕ ничего менять не надо.
А вот чтобы слепило и увязало с ФПК - надо. Я это сделаю, когда ФПК-тим устранит жесткий баг на ХМЛ-тэгах в fpdoc.

Ааа. Понятно.

в общем опять все стало =) я немного пофилосовствую , можно ?

вот мне лично хмл не нравится этот совсем =) не потому что я против хмл, а вот просто не понятно что там и куда и чего.

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

ну а в качесве маяка это дока от дельфи, потому что в отличаи от пхп у паскаля есть открытые \ закрытые(protected\public\etc) свойства

формат хранения как уже порешили лучше всего текстовый, хранение картинок пнг.

структура
1 куча вложеных папок и там описание
я бы применил структуру как она распологается на панели компонентов, облегчит поиск и понимание.
2 умный хмл, может и тот что есть пойдет, хотя опять же ИМХО он сделан не удобно
*должны поодерживаться внутрении ссылки (в свн есть?) напрмер свойство name есть у всех компонентов и что его 40 раз заполнять и копировать ? оно должно хранится в одном месте, и сделав перевод одно абзаца на другой язык , мы получим 40 переведеных абзацев !

заполнение. это самое слабое звено во первых надо показать что это просто. во первых человек и так не понимает что там и как живет а ему еще предлогают документировать это не пойми что и не пойми как.
соответсвенно имхо это должна быть программа, расположение контролов оставить дизайнерам, как это я вижу себе
1, выбираем язык ввода,
2, выбираем(вписываем) компонент\класс
2,1 програма автоматом или с помощью пользователя находит юнит где живет данный компонент
2,2 программа автоматом выводит свойства и функции с разделением на палик\паблишен и т.д.
3, пользователь заполняет и комитит изменения
3,1 для компонентов можно добавлять пару картинок


ну а следующим шагом уже будет создания проги которая собирает это все в хтмл\пдф\чмо\хлп по желанию.

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

Про формат - решайте, пробуйте. Главное - чтобы было, что "форматировать".

*должны поодерживаться внутрении ссылки (в свн есть?) напрмер свойство name есть у всех компонентов и что его 40 раз заполнять и копировать ? оно должно хранится в одном месте, и сделав перевод одно абзаца на другой язык , мы получим 40 переведеных абзацев !

1, выбираем язык ввода,
2, выбираем(вписываем) компонент\класс
2,1 програма автоматом или с помощью пользователя находит юнит где живет данный компонент
2,2 программа автоматом выводит свойства и функции с разделением на палик\паблишен и т.д.
3,1 для компонентов можно добавлять пару картинок
============
FPDOC это обеспечивает. Да он все обеспечивает, кроме вставки картинок.

ИМХО, Идеальный редактор хэлпа на конечной стадии ( HTML ) - DramWeaver. Я на нем туториал "persons" ваял.

debi12345
так ты что нибуть закомитил в свн, может так бы хоть понял что там и к чему. и на принтер ты мне не ответил =( наверно не заметил сообщения. .


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

там еще необходим пункт
4 должны быть флаги в работе и "незаконченый" с поддержкой времени

чтобы типа если в работе пол года, то про него забыли =(


ЗЫ debi12345 форум поддерживает удобное цитирование и понятное для всех для этого надо всего лишь выделить текст и нажать слева кнопку "цитировать" над аватаром.