merged
authorOleksandr Gavenko <gavenkoa@gmail.com>
Sun, 07 Aug 2011 23:49:14 +0300
changeset 924 365194e01db5
parent 923 f3b193a0e566 (current diff)
parent 922 df742eebd7a1 (diff)
child 925 43765268ec50
child 942 8aed53c326aa
merged
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/devel-codetags.rst	Sun Aug 07 23:49:14 2011 +0300
@@ -0,0 +1,66 @@
+.. -*- coding: utf-8 -*-
+
+====================
+ TODO like keywords
+====================
+.. contents::
+
+Existing resources.
+===================
+
+  http://www.python.org/dev/peps/pep-0350/
+                Codetags
+  http://tracos.org/codetag/
+                This project aims to provide a Toolset and RFC-style Pep usage
+                convention for Codetags.
+  http://java.sun.com/docs/codeconv/html/CodeConventions.doc9.html#395
+                Code Conventions for the Java TM Programming Language.
+                Programming Practices
+  http://c2.com/cgi/wiki?FixmeComment
+                Fixme Comment
+
+FIXME
+=====
+
+For things which are definitely broken, but where you want to not worry about
+it for the moment.
+
+Use FIXME to flag something that is bogus and broken.
+
+TODO
+====
+
+For useful features, optimizations or refactorings that might be worth doing
+in the future.
+
+TODO used to justify not completing code at the time it is first written.
+
+XXX
+===
+
+Use XXX in a comment to flag something that is bogus but works.
+
+For things that require more thought and that are arguably broken.
+
+An XXX demands attention and is not intended to stay in the code long. We may
+later decide that no problem exists. Or we may need to document unexpected
+behavior. If code is broken, we do not expect it to stay that way. We mark the
+problem immediately so that it is not forgotten.
+
+BUG
+===
+
+BUG [ID бага] – обозначает, что в коде есть известный баг, который ещё не исправлен.
+REVIEW
+BROKEN
+HACK
+
+TRICKY
+======
+
+Говорит о том, что код является мудрёным и нужно хорошо подумать прежде чем
+что-то в нём менять.
+
+WARNING
+=======
+
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/devel-versioning.rst	Sun Aug 07 23:49:14 2011 +0300
@@ -0,0 +1,11 @@
+=================
+ Version format.
+=================
+.. contents::
+
+Reference.
+==========
+
+  https://developer.mozilla.org/en/toolkit_version_format
+                Toolkit version format
+
--- a/emacs.rst	Sun Aug 07 23:39:37 2011 +0300
+++ b/emacs.rst	Sun Aug 07 23:49:14 2011 +0300
@@ -457,7 +457,7 @@
 
 * Useful commands.
 
-  flush-lines
+  flush-lines keep-lines
   align-regexp
   C-x C-o
   M-PageUp/M-PageDown