4796 2004-07-15 11:43:18 +0400 Odd characters in documentation file names 2009-05-10 09:32:10 +0400 1 1 4 Development Sisyphus rpm-build-python unstable all Linux CLOSED FIXED P5 minor --- 1 mhz cray darktemplar george imz ldv qa-sisyphus oldest_to_newest 17065 0 mhz 2004-07-15 11:43:18 +0400 В %_docdir/%name-%version/policy имена файлов начинаются с числа и двоеточия. Двоеточие не принадлежит к числу символов, безопасных для именования файлов: в Un*x им разделяются элементы всевозможных путей, в Windows это вообще AFAIK незаконно. Зачем вообще эта нумерация? Неужели настолько важен порядок документов в папке, чтобы нужно было возиться еще и с префиксами (для filename completion это помеха)? 18730 1 cray 2004-09-10 11:47:57 +0400 Порядок документов важен, кроме того, мне так удобно, а законность или незаконность символов в именах файлов пакета нигде и никем (AFAIK) не задукоментирована. Если я ошибаюсь - пришлите ссылку на соответствующий официально опубликованный документ, я исправлю ":" на "-", или что там будет официально разрешено в документе,, ссылку на который вы мне пришлете. Насчет того, зачем нумерация - мне так удобно. 18736 2 mhz 2004-09-10 12:09:30 +0400 Речь не о законности (законно почти все), а о потенциальной опасности тех или иных символов для скриптов и проч. Двоеточие традиционно имеет семантику разделителя, поэтому в Unix его использовать всуе не принято. "Мне так удобно" -- самый слабый аргумент, который можно услышать от maintainer'а. Удобно должно быть пользователю. Нумерация затрудняет filename completion -- кроме имени документа, пользователь при наборе должен вспомнить номер, нужный ему как собаке пятая нога. 18737 3 mhz 2004-09-10 12:10:49 +0400 Resolve as Wontfix because the user's concern wasn't invalid. 18739 4 cray 2004-09-10 12:40:56 +0400 Хорошо, тогда перечислите потенциально безопасные символы с точки зрения скриптов и пр. Насчет слабости аргумента"Мне так удобно" - он не слабее вашего "Мне так неудобно". Говорите "completion" затруднен? Зато в mc главы документа видны в естественном порядке, а не черт знает как. Вам, как пользователю, важнее completion, мне и моим знакомым важно иметь возможность прочитать документы в таком порядке, как предполагается автором, так как определения должны идти до их использования, а вот какой-то там complrtion нужен ему как "собаке пятая нога" и "зайцу стоп сигнал на хвосте". Так что наши аргументы не слабее ваших, да собственно и из той же области вам удобно - нам удобно, а как автор я имею типа право назвать файл по своему желанию. : - я на что-нть заменю, только укажите безопасный символ. Кстати, может мне их в форать 8/3 переименовать, чбы их под MS-DOS было "удобно" копировать ? Хотя лучше уж сразу в 6/3, у некоторых еще жива rt11sj. 18740 5 mhz 2004-09-10 13:12:56 +0400 (In reply to comment #4) > Хорошо, тогда перечислите потенциально безопасные символы с точки зрения > скриптов и пр. Дефис, подчеркивание, точка. > Вам, как пользователю, важнее > completion, мне и моим знакомым важно иметь возможность прочитать документы > в таком порядке, как предполагается автором, Тогда сделайте из этого руководства честный DocBook и трансформируйте в chunked html. Там будет index.html, в котором все будет упорядочено. Алфавитный порядок в неиндексированном сборище текстовых файлов -- неряшливое решение искусственной проблемы. 18744 6 cray 2004-09-10 14:14:01 +0400 Опять же - вам удобен html, мне нет. Вам удобен docbook - мне нет. То, что использется сейчас - это structured-text, который в zope / python мире является более общепринятым. Не надо пытаться устанавливать везде свои собственные законы, аргументируя это отсылкой на якобы "общеприянятые" понятия. Впрочем, если вы займетесь преобразование документации в docbook и ее поддержкой - я окажу вам всемерную помощь в поддержке вашей _неофициальной_ версии. 19663 7 mhz 2004-11-05 16:40:56 +0300 (In reply to comment #6) > Опять же - вам удобен html, мне нет. Вам удобен docbook - мне нет. То, что > использется сейчас - это structured-text, который в zope / python мире является > более общепринятым. Хорошо, только расскажите чем структурно просматривать этот structured-text, не имея под рукой Zope. > Не надо пытаться устанавливать везде свои собственные > законы, аргументируя это отсылкой на якобы "общеприянятые" понятия. Отсылка к количеству документации в дистрибутиве, созданной из DocBook, не годится? Весь GNOME, LDP... Насчет общепринятости, вот еще одна ссылка на кладезь мудрости: http://www.catb.org/~esr/writings/taoup/html/ch18s04.html 19752 8 cray 2004-11-11 15:24:05 +0300 Михаил, попробуйте все ваши вопросы задать в том же самом ключе в ответ на ваши аргументы, а не на мои высказывания. Например: 1. Чем можно структурно просматривать docbook не имея под рукой xslt, openoffice, etc? ST кстати вполне структурно выглядит в обычном текстовом редакторе, в отличие от. 2. Количество документации, созданной на ST годится? Вот примерчик книжечки полностью написанной на: http://plone.org/documentation/books/amazon_tool/0735711100/?depth:int=2 Поиск остальных примеров оставляю вам для самостоятельных упражнений. В общем, продолжать спор в ключе: "правильно так, как хочет Михаил Забалуев" мне не интересно. Опровергнуть свои доводы вы можете сами, то, что мои доводы опровержимы - я знаю без вас. При относителной равноопровержимости обеих точек зрения, моя мне нравится больше. 19785 9 mhz 2004-11-13 16:39:07 +0300 Resolution needs to be changed 19786 10 mhz 2004-11-13 16:40:38 +0300 Переименование было произведено.