Суп, псач. Как наверное единицы из вас знают, есть такие штуки как WEB
(автор — Кнут) и NOWEB (автор — Пряник). Типа пишешь как-бы новеллу на LaTeX, с
включениями кода, а потом — хуяк! И у тебя из одного файла и собственно новелла
генерится в PDF и код, который тут же можно скомпилять. Зело удобно, если
пишешь документацию к своему поделию с примерами кода. Ну или ещё какие козни
творишь.
Дык вот, пришло время охуительных историй^W^W фабулы повествования. Зачастую
смотришь на коммит свой и думаешь: «Блеадь, зойчем я это зделол?». Дык вот, а
существуют ли подвижки в плане создания самодокументирующихся патчей? Типа:

@ Так, вот здесь мы увеличим таймаут, а то старый дропает соединения от
лузеров с EDGE:
<<src/my/lib/server.cpp @@ -49,12 +49,14 @@>>=

// Нада б выставить таймаут, чтобы не засрали все коннекты
int tcpnodelay = false;
— int timeout = 9000;
+ int timeout = 100500;
int max_connections = 300;
int port = 8080;

@ Ну и тут кое-кто ниасилил function-try-block:
<<src/my/lib/my_class.cpp @@ -1,12 +1,7 @@>>=
-my_class::my_class() {
— try {
— some_init();
— } catch (const std::exception& e) {
— logger << "shit happened: " << e.what() << std::endl;
— throw;
— } catch (...) {
— logger << "funky shit happened" << std::endl;
— throw std::exception("unknown error");
— }
+my_class::my_class()
+try {
+ some_init();
+} catch (const std::exception& e) {
+ logger << "shit happened: " << e.what() << std::endl;
}

Имхо, было бы пиздато, и я бы юзал во все поля. Т.е. берёшь такое файло и оно
выцепляет из него патч, накладывает на сырца, а само это всё файло как-то пишет
в VCS¸ чтобы было удобочитаемо.

#toseen

9 comments recommend bookmark subscribe