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

Хех.....всегда сталкиваюсь с такой же проблемой!!!
Но если пишу большой проект или знаю, что его будут дописывать другой программер - я стараюсь развернуто откоментировать все строки, а в шапке пишу большой коментарий(почти в эпистолярном жанре )))) для чего етот модуль вообще нужен, какие процедуры и функции в нем сидят........и что они все вместе делают......!!!
Гуд Лак )))

А зачем разбираться, как работают процедуры? Если они правильны, то достаточно вспомнить, что они получают на вход и что выдают... А для удобочитаемости использую форматирование и табуляцию...
Если программируешь большой проект, используй юниты. С их помощью можно постараться во-первых, не делать файл из 3000 строк, а во-вторых разделить процедуры и функции по "тематике" и не нагромождать доп. фунциями главную программу.

Мне помогает разбиение программы на модули. Т.е. вынос самостоятельно написанных фукнций и процедур в отдельные модули с последующим подключением их к проекту. Таким образом снижается не только размер главного модуля программы, но и значительно облегчается понимание того что написано.
Но все-таки главную и решающую роль играет стиль написания кода. Это и осмысленные имена переменных, компонентов на форме, и осмысленно названные функции и процедуры. Согласись, что гораздо проще понять код:

Код

szAccount:= edAccount.Text;  nInsertResult:= InsertAccount(dbAccountBase, szAccount);

чем

Код

s:= edit1.Text;  n:= ia(dbBase1, s);

Так и в названиях переменных. Пиши все имена только на английском и старайся обходится без цифр. Если ты не знаешь как пишется то или иное слово - потрать пару минут, загляни в словарь. Это будет полезно и тебе (пополнишь словарный запас) и программе (она будет более читабельной).

Таким образом: развивай сначала правильный стиль написания кода. А потом дели программу на модули. И тогда все будет гораздо проще ;)

делай архивы исходников с комментариями к ним... Работает...

А еще Можно почитать умные книжки про разработку крупных программных проектов. В них можно найти готовые системы разработки, различные подходы. К примеру, мне понравилась книга Кент Бека "Экстремальное программирование".

Ну а если читать совсем не охота, то зачем задавать такие вопросы?

Рекомендации кратко такие:

1) Уделяйте внимание форматированию кода, отступам и т.п.
2) Переменные называйте так чтобы сразу было понятно, пусть будут длинными - это не страшно, например используйте "OldUserPassword" вместо трудно понятного "upsd2". Названия процедур тоже должно отражать их роль: ConnectRemoteServer будет гораздо лучше crtsrv.
3) Избегайте большой вложенности if, циклов и т.п.
4) Избегайте длинных процедур, желательно чтобы процедура целиком умещалась на экране, если длиннее - то разбивайте на несколько
5) Коментарии должны быть не очень длинные, и не очень подробные, а наоборот краткие и по существу.


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

Ну и в заключение статья Pegas:
http://forum.vingrad.ru/index.php?act=ST&f=32&t=11486

Хотелось бы еще услышать о том, как разбивать программу на плагины\модули. Как это делать? И какие готовые разработки есть?

cully
На модули? Легко! Создаешь новый файл *.pas (допустим, myfunc.pas) и выносишь в него громоздские функции, классы, стуктуры, константы и пр.пр. Этот модуль должен быть стандартным, т.е. выглядеть так:

Код

unit myfunc; interface uses  Windows; // подключаешь необходимые модули   type  // здесь пишем классы, структуры и функции  // функция писать сюда для того чтобы они видели друг друга  // и чтобы их было видно из проекта, к которму подключится этот модуль    WindowSize = record     Left, Top, Width, Height: Integer;  end;  procedure Proc(const Arg1, Arg2: TStrings);  function Funct(Arg1: Integer): String; var  // здесь глобальные переменные  GlobalVariable: Int64 = 0; const  // и константы  GlobalConstant: String = 'Hi, All!!!'; implementation  { ну а тут уже сами функции и процедуры... } procedure Proc(const Arg1, Arg2: TStrings); begin // .... end; function Funct(Arg1: Integer): String; begin  Result:= ''; end; end.

А потом подключаешь его к своей программе - кидаешь в одну папку с проектом (или регистрируешь путь в самом Дельфи) и дописываешь в раздел uses проекта.

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


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

Gloomy, я про плагины

cully
Плагины? Т.е. динамические библиотеки? Тоже ничего страшного - смотри пример
Исходник библиотеки:

Код

library testlib; uses  Windows; {$R *.res} procedure SayHello; stdcall; begin  MessageBox(0, 'Hello!', 'Message from DLL', MB_ICONINFORMATION); end; exports SayHello; begin end.

В раздел type пишешь:

Код

type  SayHelloA = procedure; stdcall;

И потом для кнопки:

Код

procedure TForm1.Button1Click(Sender: TObject); var  sh: SayHelloA;  handle: THandle; begin  handle:= LoadLibrary('testlib.dll');  if handle = 0 then exit;  @sh:= GetProcAddress(handle, 'SayHello');  if @sh = nil then exit;  sh;  FreeLibrary(handle); end;

Вот и вся мудрость

Это сообщение отредактировал(а) Gloomy - 26.10.2003, 21:04

А я в последние время стал писать каждую часть программы отдельно от программы, а потом все вместе соединать уже в проекте ....... жаль что я стразу так со всем остальным не сделал ......... да и отлаживать так удобно! А то теперь я жду когда эти 2.5Метра загрузятся в память чтобы посмотреть отдельной функции программы .......а теперь все по отдельности и быстро и просто

Gloomy, плагин это не обязательно библиотека, как писать библиотеки я знаю. Хотелось бы работать не с функциями, а с объектами, этого как раз dll нормально не позволяют делать. Многие скажут: для этого есть пакеты. Но я что-то не нашел путей обнаружения классов присутствующих в пакете и их(пакетов) динамической загрузки\выгрузки. Все просто если не вникать в проблему. Равнятся надо на .net, там можно все динамически загружать\выгружать, узнавать информацию о классах и т.д. RTTI Delphi ни в какое сравнение не идет с Reflection, с помощью Reflection можно даже классы на лету конструировать. С радостью писал бы под .net, но его малая рспространенность и большие требования к железу убивают все его премущества. Вот и хочется малой кровью добиться чего-то похожего на .net используя Delphi.

з.ы. Gloomy, и не надо из меня делать ламера.

cully

Цитата

плагин это не обязательно библиотека, как писать библиотеки я знаю

Тогда извини - я просто не понял о чем ты спрашиваешь. Ты написал выше: Gloomy, я про плагины. Вот я и подумал что ты про обычные динамические библиотеки

Цитата

Хотелось бы работать не с функциями, а с объектами, этого как раз dll нормально не позволяют делать.

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

Цитата

и не надо из меня делать ламера.

Ты обиделся на фразу "Вот и вся мудрость"? Извини пожалуйста - я никак не хотел этим тебя оскорбить Я вспомнил время когда придумал этот код и очень гордился таким изящным решением проблемы. Велико же было мое удивление когда я нашел такой же код в книжке

Это сообщение отредактировал(а) Gloomy - 27.10.2003, 17:53