Changes between Version 1 and Version 2 of TracDev/ApiChanges/1.1

Timestamp:

Apr 25, 2015, 11:40:56 PM (9 years ago)

Author:

figaro

Comment:

Cosmetic changes

TracDev/ApiChanges/1.1

@@ -2 +2 @@
 ← [../1.0] | [../1.2] →
 }}}
+
 = Documenting API changes in 1.1.x
 
@@ -13 +14 @@
 
 [[PageOutline(2-4,Summary,inline)]]
-
 
 == Prerequisites
@@ -33 +33 @@
 === Modified Dependencies
 
-See gmessage:trac-dev:nkMUY_8ILF0/rg1rsArDIewJ for a discussion about what dependencies we'll support in Trac 1.2.
+See gmessage:trac-dev:nkMUY_8ILF0/rg1rsArDIewJ for a discussion about what dependencies will be supported in Trac 1.2.
 
 ==== jQuery and jQuery UI (bundled)
@@ -79 +79 @@
 ==== Other
 
-|| Package     || Req or Opt? || Version supported ||
+|| **Package** || **Req or Opt?** || **Version supported** ||
 || SetupTools  || Required || >= 0.6, 5.4 - 5.6 are not recommended. ||
 || Git         || Optional || >= 1.5.6 ||
 || Subversion  || Optional || >= 1.6 ||
 || !DocUtils   || Optional || >= 0.3.9 ||
-|| Textile    || Optional || >= 2.0 ||
-|| Pygments   || Optional || >= 0.6. Let's consider bumping the requirement to at least 1.0, released in [https://pypi.python.org/pypi/Pygments/1.0 2008]  ||
-... please add any dependencies I've overlooked.
+|| Textile     || Optional || >= 2.0 ||
+|| Pygments    || Optional || >= 0.6. Let's consider bumping the requirement to at least 1.0, released in [https://pypi.python.org/pypi/Pygments/1.0 2008]  ||
+
+Please add any dependencies overlooked.
 
 `ConfigObj` is no longer a required dependency for the `AuthzPolicy` permission policy (`tracopt.perm.authz_policy`) since Trac 1.1.5.
@@ -92 +93 @@
 === Deprecated Modules Removed
 
-TODO Remove support for `mod_python` (see TracModPython) ... or maybe not. It seems the project is alive (comment:34:ticket:11605).
+TODO Remove support for `mod_python` (see TracModPython), although the project is alive (comment:34:ticket:11605).
 
 DONE: Removed Enscript, SilverCity and PHP renderers in Trac 1.1.3. (#11795)
@@ -99 +100 @@
 
 None!
-
 
 == Detailed List of Developer Visible Changes #list
@@ -123 +123 @@
 
 === Modified Interfaces
+
 ==== `IWikiChangeListener`            ^[source:trunk/trac/wiki/api.py@13198:53#L32 (1.1.3)] [source:branches/1.0-stable/trac/wiki/api.py@11490#L33 (1.0)]^ #IWikiChangeListener
 
@@ -132 +133 @@
 
 === New Interfaces
+
 ==== `trac.notification.api.INotificationDistributor` ^[source:trunk/trac/notification/api.py@13454#L29 (1.1.3)]^ #INotificationDistributor
 
@@ -162 +164 @@
 ==== `Environment.get_db_cnx` has been removed #get_db_cnx in Trac 1.1.2
 
-Following the [../0.12#get_db_cnx deprecation] made in 0.12, the method `Environment.get_db_cnx` has been removed. (#11605)
-
-One should now only use the //context managers// for retrieving a database Connection
-in read or write mode.
+Following the [../0.12#get_db_cnx deprecation] made in 0.12, the method `Environment.get_db_cnx` has been removed (#11605).
+
+One should now only use the //context managers// for retrieving a database Connection in read or write mode.
  - a **read-only** Connection can be used to form queries:
    {{{#!python
@@ -199 +200 @@
 === Template and CSS changes in Trac 1.1.2
 
-`tt` tags are not support in HTML5 and have been replaced with `code` tags in Trac (#11094). The styling of `tt` and `code` tags is the same in Trac , but `code` tags should be used since the styling for `tt` tags will be removed in a future version of Trac.
+`tt` tags are not supported in HTML5 and have been replaced with `code` tags in Trac (#11094). The styling of `tt` and `code` tags is the same in Trac, but `code` tags should be used, since the styling for `tt` tags will be removed in a future version of Trac.
 
 The `about.css` stylesheet has been removed and the rules contained in that stylesheet have been moved to `trac.css`. The table of environment information on the //Error// and //About// pages have been extracted to a new template `environment_info.html` and the markup and associated rules in the stylesheet have been significantly changed.
 
-//Many more changes to be added, depending on how details we want to get. TracUpgrade#CustomizedTemplates claims that changes to `id`s and CSS `class`es will be documented in ApiChanges.//
+//Many more changes to be added, depending on how detailed we want to get. TracUpgrade#CustomizedTemplates claims that changes to `id`s and CSS `class`es will be documented in ApiChanges.//
 
 
@@ -223 +224 @@
 TODO: Remove //Since// info from docstrings for Trac < 0.12.
 
-//This is a work in progress - coverage is still not yet complete.//
-
+//This is a work in progress - coverage is not yet complete.//