Thread: [brlcad-commits] SF.net SVN: brlcad:[46880] brlcad/trunk/doc/deprecation.txt (Page 3)
Open Source Solid Modeling CAD
Brought to you by:
brlcad
From: <sta...@us...> - 2011-09-23 21:44:10
|
Revision: 46880 http://brlcad.svn.sourceforge.net/brlcad/?rev=46880&view=rev Author: starseeker Date: 2011-09-23 21:44:04 +0000 (Fri, 23 Sep 2011) Log Message: ----------- add version Modified Paths: -------------- brlcad/trunk/doc/deprecation.txt Modified: brlcad/trunk/doc/deprecation.txt =================================================================== --- brlcad/trunk/doc/deprecation.txt 2011-09-23 21:42:05 UTC (rev 46879) +++ brlcad/trunk/doc/deprecation.txt 2011-09-23 21:44:04 UTC (rev 46880) @@ -50,7 +50,7 @@ liborle remove liborle and the tools using it, fb-orle, orle-fb, orle-pix and - pix-orle + pix-orle [deprecated 7.20] tclscripts/lib Mged, Database, Db, Dm, Drawable, Display, QuadDisplay, View -> Ged [deprecated 7.20] This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <br...@us...> - 2011-12-01 22:03:39
|
Revision: 47738 http://brlcad.svn.sourceforge.net/brlcad/?rev=47738&view=rev Author: brlcad Date: 2011-12-01 22:03:32 +0000 (Thu, 01 Dec 2011) Log Message: ----------- all of the bu_tcl_* functions are no longer public API. Modified Paths: -------------- brlcad/trunk/doc/deprecation.txt Modified: brlcad/trunk/doc/deprecation.txt =================================================================== --- brlcad/trunk/doc/deprecation.txt 2011-12-01 21:58:59 UTC (rev 47737) +++ brlcad/trunk/doc/deprecation.txt 2011-12-01 22:03:32 UTC (rev 47738) @@ -809,3 +809,5 @@ s/rt_dist_line3_line3/bn_dist_line3_line3/g s/rt_dist_line3_lseg3/bn_dist_line3_lseg3/g functions moved from librt to libbn [7.21] +s/bu_tcl_\([^(]*\)([^,]*?[[:space:]]*,[^,]*?[[:space:]]*,\(.*\)/bu_tcl_units_conversion(\1/g + removed all bu_tcl_*() functions, use native bu function [7.21] This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <br...@us...> - 2011-12-01 22:06:57
|
Revision: 47739 http://brlcad.svn.sourceforge.net/brlcad/?rev=47739&view=rev Author: brlcad Date: 2011-12-01 22:06:51 +0000 (Thu, 01 Dec 2011) Log Message: ----------- oops, fix the regex to use both matched patterns. Modified Paths: -------------- brlcad/trunk/doc/deprecation.txt Modified: brlcad/trunk/doc/deprecation.txt =================================================================== --- brlcad/trunk/doc/deprecation.txt 2011-12-01 22:03:32 UTC (rev 47738) +++ brlcad/trunk/doc/deprecation.txt 2011-12-01 22:06:51 UTC (rev 47739) @@ -809,5 +809,5 @@ s/rt_dist_line3_line3/bn_dist_line3_line3/g s/rt_dist_line3_lseg3/bn_dist_line3_lseg3/g functions moved from librt to libbn [7.21] -s/bu_tcl_\([^(]*\)([^,]*?[[:space:]]*,[^,]*?[[:space:]]*,\(.*\)/bu_tcl_units_conversion(\1/g +s/bu_tcl_\([^(]*\)([^,]*?[[:space:]]*,[^,]*?[[:space:]]*,\(.*\)/bu_\1(\2/g removed all bu_tcl_*() functions, use native bu function [7.21] This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <br...@us...> - 2011-12-02 04:16:56
|
Revision: 47762 http://brlcad.svn.sourceforge.net/brlcad/?rev=47762&view=rev Author: brlcad Date: 2011-12-02 04:16:49 +0000 (Fri, 02 Dec 2011) Log Message: ----------- ws and 3 months should be necessary, not sufficient Modified Paths: -------------- brlcad/trunk/doc/deprecation.txt Modified: brlcad/trunk/doc/deprecation.txt =================================================================== --- brlcad/trunk/doc/deprecation.txt 2011-12-02 04:16:02 UTC (rev 47761) +++ brlcad/trunk/doc/deprecation.txt 2011-12-02 04:16:49 UTC (rev 47762) @@ -17,7 +17,7 @@ b) during a minor release provided the change was publicly announced as deprecated beforehand AND sufficient deprecation warning was given via either i) three minor releases included the deprecation - notice, or ii) three months passed since deprecation + notice, and ii) at least three months passed since deprecation c) during a minor release provided there still exists an equivalent alternative interface that will not impose an undue burden on users @@ -53,13 +53,11 @@ 7.20 ---- -liborle +liborle remove liborle and the tools using it, fb-orle, orle-fb, orle-pix and pix-orle [deprecated 7.20] - tclscripts/lib Mged, Database, Db, Dm, Drawable, Display, QuadDisplay, View -> Ged [deprecated 7.20] - librt bspline primitive [deprecated 7.20] poly primitive [deprecated 7.20] This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <br...@us...> - 2011-12-07 23:49:09
|
Revision: 47847 http://brlcad.svn.sourceforge.net/brlcad/?rev=47847&view=rev Author: brlcad Date: 2011-12-07 23:49:01 +0000 (Wed, 07 Dec 2011) Log Message: ----------- document the minimally impacting change to bu_cmd() and (hopefully, untested) fix several other minimally impacting regexes that escaped ()'s incorrectly. perl captures matches with () and matches literals with \(\). logic was reversed. Modified Paths: -------------- brlcad/trunk/doc/deprecation.txt Modified: brlcad/trunk/doc/deprecation.txt =================================================================== --- brlcad/trunk/doc/deprecation.txt 2011-12-07 23:46:44 UTC (rev 47846) +++ brlcad/trunk/doc/deprecation.txt 2011-12-07 23:49:01 UTC (rev 47847) @@ -809,13 +809,15 @@ functions moved from librt to libbn [7.21] s/bu_tcl_setup/Bu_Init/g removed bu_tcl_setup() in favor of Bu_Init() [7.21] -s/bu_tcl_\([^(]*\)([^,]*?[[:space:]]*,[^,]*?[[:space:]]*,\(.*\)/bu_\1(\2/g - removed all bu_tcl_*() functions, use native bu function [7.21] -s/bu_badmagic_tcl\([^(]*\)([^,]*?[[:space:]]*,\(.*\)/bu_badmagic(\1/g +s/bu_tcl_([^(]*)\([^,]*?[[:space:]]*,[^,]*?[[:space:]]*,(.*)/bu_\1(\2/g + removed all bu_tcl_*() functions, leaving off interp and using native bu function [7.21] +s/bu_badmagic_tcl\([^,]*?[[:space:]]*,(.*)/bu_badmagic(\1/g removed bu_badmagic_tcl() in favor of bu_badmagic() [7.21] -s/\(.*\)_CK\(.*\)_TCL\([^(]*\)([^,]*?[[:space:]]*,\(.*\)/\1_CK\2(\3/g +s/(.*)_CK(.*)_TCL\([^,]*?[[:space:]]*,(.*)/\1_CK\2(\3/g removed all *_CK*_TCL() macros (e.g., BU_CKMAG_TCL, RT_CK_DBI_TCL, etc) in favor of non-TCL macros [7.21] s/bu_image/icv_image/g - moved bu_image* functions to libicv as icv_image* + moved bu_image* functions to libicv as icv_image* [7.21] s/BU_IMAGE/ICV_IMAGE/g - moved BU_IMAGE* macros to icv.h as ICV_IMAGE* + moved BU_IMAGE* macros to icv.h as ICV_IMAGE* [7.21] +s/bu_cmd\(([^,]*?),[[:space:]]*([^,]*?),[[:space:]]*([^,]*?),[[:space:]]*([^,)]*?),[[:space:]]*([^)]*?)\)/bu_cmd(\4, \2, \3, \5, \1, NULL)/g + inputs then outputs. swapped bu_cmd's 4th parameter to 1st, 1st to 5th, and added a new return value hook last. [7.21] This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <br...@us...> - 2011-12-08 01:05:06
|
Revision: 47853 http://brlcad.svn.sourceforge.net/brlcad/?rev=47853&view=rev Author: brlcad Date: 2011-12-08 01:04:59 +0000 (Thu, 08 Dec 2011) Log Message: ----------- V3*_TOL() macros in vmath used to assume a structure with a ->dist element, which is kinda silly from an API standpoint. made them be a simple tolerance value. Modified Paths: -------------- brlcad/trunk/doc/deprecation.txt Modified: brlcad/trunk/doc/deprecation.txt =================================================================== --- brlcad/trunk/doc/deprecation.txt 2011-12-08 00:55:04 UTC (rev 47852) +++ brlcad/trunk/doc/deprecation.txt 2011-12-08 01:04:59 UTC (rev 47853) @@ -821,3 +821,5 @@ moved BU_IMAGE* macros to icv.h as ICV_IMAGE* [7.21] s/bu_cmd\(([^,]*?),[[:space:]]*([^,]*?),[[:space:]]*([^,]*?),[[:space:]]*([^,)]*?),[[:space:]]*([^)]*?)\)/bu_cmd(\4, \2, \3, \5, \1, NULL)/g inputs then outputs. swapped bu_cmd's 4th parameter to 1st, 1st to 5th, and added a new return value hook last. [7.21] +s/V3(.*)_TOL\(([^,]*,)([^,]*,)([^,]*,)([^)]*)\)/V3\1_TOL(\1\2\3(\4)->dist)/g + V3RPP_OVERLAP_TOL(), V3PT_IN_RPP_TOL(), and V3PT_OUT_RPP_TOL() tol parameter changed to value [7.21] This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <br...@us...> - 2012-05-02 03:17:19
|
Revision: 50401 http://brlcad.svn.sourceforge.net/brlcad/?rev=50401&view=rev Author: brlcad Date: 2012-05-02 03:17:11 +0000 (Wed, 02 May 2012) Log Message: ----------- per IRC discussion in the aftermath of an autotools removal revert, tighten up the deprecation language to specify two minor release needing to include the deprecation notice. include an example so it's even more explicit and not subject to intepretation. strictly speaking, this reduces our deprecation window by a minor but makes the policy about as tight as it can get without being reckless or non-existent. Modified Paths: -------------- brlcad/trunk/doc/deprecation.txt Modified: brlcad/trunk/doc/deprecation.txt =================================================================== --- brlcad/trunk/doc/deprecation.txt 2012-05-02 03:14:08 UTC (rev 50400) +++ brlcad/trunk/doc/deprecation.txt 2012-05-02 03:17:11 UTC (rev 50401) @@ -16,8 +16,9 @@ b) during a minor release provided the change was publicly announced as deprecated beforehand AND sufficient deprecation warning was - given via either i) three minor releases included the deprecation - notice, and ii) at least three months passed since deprecation + given via i) two minor releases included the deprecation notice, + and ii) at least three months (90 days) have passed since the + deprecation was announced c) during a minor release provided there still exists an equivalent alternative interface that will not impose an undue burden on users @@ -35,6 +36,15 @@ either during compile-time with #warning pre-processor declarations or during run-time with print statements. +Example: Say we decided during 7.50.3 development to remove +rt_shootray() from our API without a replacement that would qualify as +"minimally impacting". We'd annotate the deprecation here, mark the +function as DEPRECATED in the API header, and post the 7.50.4 release. +The soonest that function could be removed would be in the 7.54.0 +release during 7.53 development. It could NOT be removed in 7.54.2 +since it's a patch version, prior to the 7.54 release line, nor even +during 7.54.0 if less than 90 days had passed since 7.50.6 was posted. + The items listed below are interfaces that are deprecated or obsolete, categorized by the release in which the change was made. If the change involved a rename/removal of a routine, both the original and This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <br...@us...> - 2012-05-26 19:00:39
|
Revision: 50707 http://brlcad.svn.sourceforge.net/brlcad/?rev=50707&view=rev Author: brlcad Date: 2012-05-26 19:00:33 +0000 (Sat, 26 May 2012) Log Message: ----------- NEWS is only for (non-developer) user-visible changes. annotate %S change to obsolete in doc/deprecation.txt Modified Paths: -------------- brlcad/trunk/doc/deprecation.txt Modified: brlcad/trunk/doc/deprecation.txt =================================================================== --- brlcad/trunk/doc/deprecation.txt 2012-05-26 19:00:22 UTC (rev 50706) +++ brlcad/trunk/doc/deprecation.txt 2012-05-26 19:00:33 UTC (rev 50707) @@ -198,7 +198,6 @@ DIR_* -> RT_DIR_* [deprecated 7.14] include/bu.h bu_fopen_uniq -> fopen [deprecated 7.14] - %S format specifier -> %V format specifier for bu_vls [deprecated 7.14] mged tops -g -u -> now default behavior [deprecated 7.14] -n option -> -c option [deprecated 7.14] @@ -236,6 +235,11 @@ * OBSOLETE * ************ +7.22.0 +------ +include/bu.h + %S format specifier -> %V format specifier for bu_vls [deprecated 7.14] + 7.20.2 ------ cat-fb This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <tbr...@us...> - 2012-05-26 19:18:00
|
Revision: 50709 http://brlcad.svn.sourceforge.net/brlcad/?rev=50709&view=rev Author: tbrowder2 Date: 2012-05-26 19:17:53 +0000 (Sat, 26 May 2012) Log Message: ----------- clarify instructions for the obsolete step Modified Paths: -------------- brlcad/trunk/doc/deprecation.txt Modified: brlcad/trunk/doc/deprecation.txt =================================================================== --- brlcad/trunk/doc/deprecation.txt 2012-05-26 19:03:36 UTC (rev 50708) +++ brlcad/trunk/doc/deprecation.txt 2012-05-26 19:17:53 UTC (rev 50709) @@ -45,6 +45,15 @@ since it's a patch version, prior to the 7.54 release line, nor even during 7.54.0 if less than 90 days had passed since 7.50.6 was posted. +When it is finally removed, remove its entry in the DEPRECATED section +and move it to the OBSOLETE section under the version entry in which +it was removed. Make sure the entry has a reference to the version +in which the item was first classified as deprecated. See the %S +entry for an example. + +DEPRECATED/OBSOLETE Items +------------------------- + The items listed below are interfaces that are deprecated or obsolete, categorized by the release in which the change was made. If the change involved a rename/removal of a routine, both the original and This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <car...@us...> - 2012-08-08 15:38:22
|
Revision: 51816 http://brlcad.svn.sourceforge.net/brlcad/?rev=51816&view=rev Author: carlmoore Date: 2012-08-08 15:38:16 +0000 (Wed, 08 Aug 2012) Log Message: ----------- remove trailing/blanks/tabs and fix spellings Modified Paths: -------------- brlcad/trunk/doc/deprecation.txt Modified: brlcad/trunk/doc/deprecation.txt =================================================================== --- brlcad/trunk/doc/deprecation.txt 2012-08-08 15:35:27 UTC (rev 51815) +++ brlcad/trunk/doc/deprecation.txt 2012-08-08 15:38:16 UTC (rev 51816) @@ -105,7 +105,7 @@ bu_glong() -> ntohl() [deprecated 7.18] bu_pshort() -> htons() [deprecated 7.18] bu_plong() -> htonl() [deprecated 7.18] - bu_plonglong() -> htonll() [deprecated 7.18] + bu_plonglong() -> htonll() [deprecated 7.18] db.h rt_fastf_float() -> ntohf() [deprecated 7.18] rt_mat_dbmat() -> htonf() [deprecated 7.18] @@ -406,7 +406,7 @@ Unless noted otherwise, expressions are shown using Perl syntax and may need adjustment (particularly quoting of '(', ')', and '|' -characters) for other environments. Most expressions will apply with: +characters) for other environments. Most expressions will apply with: perl -0777 -pi -e 'EXPRESSION' FILE @@ -757,7 +757,7 @@ bu_vlb_getBuffer() remamed to bu_vlb_addr() [7.18] s/bu_vlb_getBufferLength\(/bu_vlb_buflen(/g - bu_vlb_getBufferLength() remamed to bu_vlb_buflen() [7.18] + bu_vlb_getBufferLength() renamed to bu_vlb_buflen() [7.18] s/V2APPROXEQUAL\(/V2NEAR_EQUAL(/g V2APPROXEQUAL() renamed to V2NEAR_EQUAL() [7.18] @@ -864,4 +864,4 @@ s/bu_count_path(.*)\);/bu_dir_list\1, NULL);/g made bu_dir_list() return the number of entries [7.21] s/bu_strcmpm\((.*),([^,]*)\)/bu_strcmp(\1)/g - no use for label paramter, convert to bu_strcmp() [7.21] + no use for label parameter, convert to bu_strcmp() [7.21] This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <car...@us...> - 2012-10-16 20:48:31
|
Revision: 53138 http://brlcad.svn.sourceforge.net/brlcad/?rev=53138&view=rev Author: carlmoore Date: 2012-10-16 20:48:25 +0000 (Tue, 16 Oct 2012) Log Message: ----------- fix spelling Modified Paths: -------------- brlcad/trunk/doc/deprecation.txt Modified: brlcad/trunk/doc/deprecation.txt =================================================================== --- brlcad/trunk/doc/deprecation.txt 2012-10-16 20:44:55 UTC (rev 53137) +++ brlcad/trunk/doc/deprecation.txt 2012-10-16 20:48:25 UTC (rev 53138) @@ -754,7 +754,7 @@ nmg_struct_counts() renamed to nmg_pr_m_struct_counts() [7.18] s/bu_vlb_getBuffer\(/bu_vlb_addr(/g - bu_vlb_getBuffer() remamed to bu_vlb_addr() [7.18] + bu_vlb_getBuffer() renamed to bu_vlb_addr() [7.18] s/bu_vlb_getBufferLength\(/bu_vlb_buflen(/g bu_vlb_getBufferLength() renamed to bu_vlb_buflen() [7.18] This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <br...@us...> - 2012-10-25 13:52:45
|
Revision: 53352 http://brlcad.svn.sourceforge.net/brlcad/?rev=53352&view=rev Author: brlcad Date: 2012-10-25 13:52:38 +0000 (Thu, 25 Oct 2012) Log Message: ----------- some folks would like librtserver to be an external project and I'm inclined to oblige. this will allow us to eliminate all references to java and a common point of misunderstanding from users Modified Paths: -------------- brlcad/trunk/doc/deprecation.txt Modified: brlcad/trunk/doc/deprecation.txt =================================================================== --- brlcad/trunk/doc/deprecation.txt 2012-10-25 12:17:14 UTC (rev 53351) +++ brlcad/trunk/doc/deprecation.txt 2012-10-25 13:52:38 UTC (rev 53352) @@ -67,6 +67,8 @@ 7.22 ---- +librtserver + becoming stand-alone project, removes optional java dependency [deprecated 7.22] mged em, e_muves, l_muves, lm, read_muves, and t_muves MUVES-specific commands [deprecated 7.22] This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <br...@us...> - 2012-10-30 01:44:55
|
Revision: 53397 http://brlcad.svn.sourceforge.net/brlcad/?rev=53397&view=rev Author: brlcad Date: 2012-10-30 01:44:49 +0000 (Tue, 30 Oct 2012) Log Message: ----------- deprecated bu_parse_mm(). looks like it's not actually used anywhere, but it is publicly declared and has been for some time. Modified Paths: -------------- brlcad/trunk/doc/deprecation.txt Modified: brlcad/trunk/doc/deprecation.txt =================================================================== --- brlcad/trunk/doc/deprecation.txt 2012-10-29 12:41:42 UTC (rev 53396) +++ brlcad/trunk/doc/deprecation.txt 2012-10-30 01:44:49 UTC (rev 53397) @@ -67,6 +67,8 @@ 7.22 ---- +bu.h + bu_parse_mm() [deprecated 7.22] librtserver becoming stand-alone project, removes optional java dependency [deprecated 7.22] mged This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |