Re: Remove all CF comments

2012-03-01 Thread denstar

If you need a tool that understands tags, the jericho html parser is
probably a good bet.  It won't get script comments though.

:den

-- 
I don't think nationalism is alone holding the field; it's in contention
with a lot of different things.
Peter Singer

~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350171
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


RE: Arabic / Other languages POI Excel Writing

2012-03-01 Thread IT (Pradeep Viswanathan)

Our community has already tested it :)

http://robertdudley.wordpress.com/2010/05/07/upgrade-java-poi-for-better-excel-support-in-coldfusion-8/

Guess it's going to be safe, will report if I face any issues.  

Thx  rgds,
Pradeep Viswanathan R 


-Original Message-
From: Leigh [mailto:cfsearch...@yahoo.com] 
Sent: Wednesday, February 29, 2012 8:56 PM
To: cf-talk
Subject: Re: Arabic / Other languages POI Excel Writing


 I used the same source with CF 8 and 9 and it works properly in CF 9.
Good to hear!  I guess some of the changes between poi v2.5 (CF8) and v3.5 
(CF9) must have involved unicode  :)


 Guess updating few with the new versions will solve the issue. 
If they are compatible with CF8, yes.  (I do not know). Just keep in mind the 
POI jars are also used by CF8. So there is the possibility updating the jars 
*might* break other things.


-Lei



~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350172
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


Re: Remove all CF comments

2012-03-01 Thread James Holmes

This is why we pair program. Eventually everyone on the team has seen each
bit of code in the app (or at least most of it) and when new people come
along they get to sit with someone who knows the app well and can reinforce
the design expressed in the tests. Regardless of skill level they can then
maintain the app, because face to face communication works better than
written documentation.

--
Shu Ha Ri: Agile and .NET blog
http://www.bifrost.com.au/


On 1 March 2012 00:41, Bryan Stevenson br...@electricedgesystems.comwrote:


 Bingo Steve...well said!

 On Wed, 2012-02-29 at 08:25 -0500, Steve 'Cutter' Blades wrote:

  Beautiful sentiment, *if* you didn't inherit a 3500 template legacy
  application originally written on CF 4.
 
  Both (comments and TDD) have their place. Fact is, what is simple and
  clear and second nature for me is Greek to a noob, and I train those all
  of the time. Comments are for those who come behind, remembering that
  not all of them share my level of skill (or my preconceptions of what is
  right and wrong to do).



~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350173
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


Re: Remove all CF comments

2012-03-01 Thread Dave Watts

 This is why we pair program. Eventually everyone on the team has seen each
 bit of code in the app (or at least most of it) and when new people come
 along they get to sit with someone who knows the app well and can reinforce
 the design expressed in the tests. Regardless of skill level they can then
 maintain the app, because face to face communication works better than
 written documentation.

That's great, but it's not a solution for everything. What happens
when a consultancy develops and delivers an application to a customer,
who will maintain it in the future? What happens to applications which
just don't get that much maintenance? I was just contacted this week
about an .NET assembly I'd built five years ago that interacts with
Adobe Connect's API. I didn't remember whether it had the ability to
change a user's password in an external system, because it wasn't part
of the specification (and therefore wasn't part of the test). Turns
out that the API call used to create a user also works to modify that
users, so the user of the assembly can just use the same method call.

You seem to be staking a lot on saying no one ever needs comments,
anywhere, for any reason and I just don't see why that's the hill you
want to die on. Comments are not the exclusive solution to writing
maintainable code, no one's saying they are, but they do provide
something very simple that TDD and pair programming do not - the
ability to explain your intent to any future reader of that source
code.

Dave Watts, CTO, Fig Leaf Software
http://www.figleaf.com/
http://training.figleaf.com/

Fig Leaf Software is a Veteran-Owned Small Business (VOSB) on
GSA Schedule, and provides the highest caliber vendor-authorized
instruction at our training centers, online, or onsite.

~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350174
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


Re: Remove all CF comments

2012-03-01 Thread Michael Stemle

So what do you do ten years later when nobody on the team was there when the 
code was written?

--
~ Mike Stemle, Jr.

On Feb 29, 2012, at 18:25, James Holmes james.hol...@gmail.com wrote:

 
 This is why we pair program. Eventually everyone on the team has seen each
 bit of code in the app (or at least most of it) and when new people come
 along they get to sit with someone who knows the app well and can reinforce
 the design expressed in the tests. Regardless of skill level they can then
 maintain the app, because face to face communication works better than
 written documentation.
 
 --
 Shu Ha Ri: Agile and .NET blog
 http://www.bifrost.com.au/
 
 
 On 1 March 2012 00:41, Bryan Stevenson br...@electricedgesystems.comwrote:
 
 
 Bingo Steve...well said!
 
 On Wed, 2012-02-29 at 08:25 -0500, Steve 'Cutter' Blades wrote:
 
 Beautiful sentiment, *if* you didn't inherit a 3500 template legacy
 application originally written on CF 4.
 
 Both (comments and TDD) have their place. Fact is, what is simple and
 clear and second nature for me is Greek to a noob, and I train those all
 of the time. Comments are for those who come behind, remembering that
 not all of them share my level of skill (or my preconceptions of what is
 right and wrong to do).
 
 
 
 

~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350175
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


Re: Remove all CF comments

2012-03-01 Thread James Holmes

I don't see why you care...

--
Shu Ha Ri: Agile and .NET blog
http://www.bifrost.com.au/


On 1 March 2012 22:30, Dave Watts dwa...@figleaf.com wrote:

  I just don't see why that's the hill you
 want to die on.


~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350176
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


Re: Remove all CF comments

2012-03-01 Thread James Holmes

Read the tests.

--
Shu Ha Ri: Agile and .NET blog
http://www.bifrost.com.au/


On 1 March 2012 22:33, Michael Stemle themanchic...@gmail.com wrote:


 So what do you do ten years later when nobody on the team was there when
 the code was written?




~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350177
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


Re: Remove all CF comments

2012-03-01 Thread Dave Watts

   I just don't see why that's the hill you want to die on.

 I don't see why you care...

Presumably for the same reason you cared enough to post in the first place?

Dave Watts, CTO, Fig Leaf Software
http://www.figleaf.com/
http://training.figleaf.com/

Fig Leaf Software is a Veteran-Owned Small Business (VOSB) on
GSA Schedule, and provides the highest caliber vendor-authorized
instruction at our training centers, online, or onsite

~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350178
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


Re: Remove all CF comments

2012-03-01 Thread Dave Watts

  So what do you do ten years later when nobody on the team was there when
  the code was written?

 Read the tests.

Wait a sec. Here's a summary of what's been posted.

You: Don't use comments, use tests.
Cutter, me: Comments can help those who come to the source code later
in ways that tests may not.
You: That's why we pair program.
Michael: What if all the developers who worked on the project are long gone?
You: Read the tests.

Can you see why that's not a satisfactory answer to the people who
disagree with you?

Dave Watts, CTO, Fig Leaf Software
http://www.figleaf.com/
http://training.figleaf.com/

Fig Leaf Software is a Veteran-Owned Small Business (VOSB) on
GSA Schedule, and provides the highest caliber vendor-authorized
instruction at our training centers, online, or onsite.

~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350179
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


Re: Remove all CF comments

2012-03-01 Thread James Holmes

That's misrepresenting the thread. This is more accurate:

Me: Don't use comments, use tests.
Cutter: Noobs can't read tests
Me: That's why we pair program.
Michael: What do *you* do if all the developers who worked on the project
are long gone?
You: Read the tests. (implication; I'm not a noob).

--
Shu Ha Ri: Agile and .NET blog
http://www.bifrost.com.au/


On 1 March 2012 22:49, Dave Watts dwa...@figleaf.com wrote:


   So what do you do ten years later when nobody on the team was there
 when
   the code was written?
 
  Read the tests.

 Wait a sec. Here's a summary of what's been posted.

 You: Don't use comments, use tests.
 Cutter, me: Comments can help those who come to the source code later
 in ways that tests may not.
 You: That's why we pair program.
 Michael: What if all the developers who worked on the project are long
 gone?
 You: Read the tests.

 Can you see why that's not a satisfactory answer to the people who
 disagree with you?

 Dave Watts, CTO, Fig Leaf Software
 http://www.figleaf.com/
 http://training.figleaf.com/

 Fig Leaf Software is a Veteran-Owned Small Business (VOSB) on
 GSA Schedule, and provides the highest caliber vendor-authorized
 instruction at our training centers, online, or onsite.

 

~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350180
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


Re: Remove all CF comments

2012-03-01 Thread Dave Watts

  You: Don't use comments, use tests.
  Cutter, me: Comments can help those who come to the source code later
  in ways that tests may not.
  You: That's why we pair program.
  Michael: What if all the developers who worked on the project are long
  gone?
  You: Read the tests.

 That's misrepresenting the thread. This is more accurate:

 Me: Don't use comments, use tests.
 Cutter: Noobs can't read tests
 Me: That's why we pair program.
 Michael: What do *you* do if all the developers who worked on the project
 are long gone?
 You: Read the tests. (implication; I'm not a noob).

No, I think that's less representative than what I wrote:

Cutter, me: Comments can help those who come to the source code later
in ways that tests may not.

Note the me there. Cutter mentioned noobs, I mentioned ways that
comments provide information that tests don't. Again, I specified two
cases where tests and pair programming wouldn't solve problems I had,
and comments could. These are actual cases from my own personal
experience in the last couple of weeks. If I accepted your answers at
face value, they would contradict my personal experience from these
two cases.

Look, I think that TDD is great. And I think that pair programming is
great, although it's not an option for many work environments.
Everybody should do these things if they can, and they will solve more
problems than comments would. But you have said, basically, that there
is NO POSSIBLE CASE where comments can solve a problem that TDD and
pair programming can't, and I think that's going to contradict many
people's experiences. That's a pretty absolutist position. Hell, I
suspect that if I asked Kent Beck himself, he'd say there are still
some cases where comments provide value that TDD doesn't.

Dave Watts, CTO, Fig Leaf Software
http://www.figleaf.com/
http://training.figleaf.com/

Fig Leaf Software is a Veteran-Owned Small Business (VOSB) on
GSA Schedule, and provides the highest caliber vendor-authorized
instruction at our training centers, online, or onsite.

~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350181
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


Re: Remove all CF comments

2012-03-01 Thread Mike Kear

I dont understand what's the problem with comments anyway.So what if we
have comments peppered through the code?Do they slow down processing in
any significant way?Yes, they cause the files to be somewhat larger,
but if all that means is a bit more disk space gets used,  so what?If
they reduce maintenance cost because its quicker for other developers to
maintain the code later on, that must surely more than offset any overhead
due to the existence of comments.

I get that the tests in TDD are a good way to see what's happening (or
supposed to happen) in code.  But whats the problem if there are comments
in there too?   (Assuming they're accurately reflecting what's going on in
the code  - if they're misleading because they reflect old or trial
versions of the logic, that's bad but none of us is talking about that are
we?)


I just dont understand why this is even a discussion in the  first place.
As someone who often has to work on code that others have built before me
(and normally aren't around to ask questions of)  I can testify that
comments make any program file MUCH MUCH MUCH easier to work on. As I
said earlier in this thread,  I once had to work on a 1500 line convoluted
file, with nested cfif clientiD =   peppered through it,  just to change
some text being displayed. It took me hours to find the exact line I
had to correct because it wasnt every instance of the text in the file, but
only one that had to be changed.  It certainly didn't justify spending ages
and ages looking through the whole logic of the application just to make a
little tweak.   A few comments here or there would have meant it cost the
client a fraction of what I billed him for my time for that little job,
then i could have got on to another much more important job he wanted done.

You dont want comments in your code?  I get that.   Dont know why you dont,
 but I get it.   But I'm a contractor who does a lot of temp work on
existing code bases not written by me.I know I go a lot faster when I
have comments I can read.   Yes, I can read code,  and I can write code.
 But the comments make it a LOT faster for me to work out what I'm working
on and how to make the change I'm asked to do.


Cheers
Mike Kear
Windsor, NSW, Australia
Adobe Certified Advanced ColdFusion Developer
AFP Webworks
http://afpwebworks.com
ColdFusion 9 Enterprise, PHP, ASP, ASP.NET hosting from AUD$15/month




On Fri, Mar 2, 2012 at 2:04 AM, James Holmes james.hol...@gmail.com wrote:


 That's misrepresenting the thread. This is more accurate:

 Me: Don't use comments, use tests.
 Cutter: Noobs can't read tests
 Me: That's why we pair program.
 Michael: What do *you* do if all the developers who worked on the project
 are long gone?
 You: Read the tests. (implication; I'm not a noob).

 --
 Shu Ha Ri: Agile and .NET blog
 http://www.bifrost.com.au/





~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350182
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


Re: Remove all CF comments

2012-03-01 Thread Russ Michaels

I will add my 2p that uncommented code drives me nuts.
when you have to work on an app you have never seen before the lack of any
useful comments usually results in it taking many x longer to figure stuff
out and get up and running with the app.
If you have a load a load of documentation and tests distributed with the
app then than of course can help too, but this is usually not the cas ein
my experience, any docs and tests are on someone else's computer somewhere
and not distributed with the app at all.


On Thu, Mar 1, 2012 at 3:21 PM, Dave Watts dwa...@figleaf.com wrote:


   You: Don't use comments, use tests.
   Cutter, me: Comments can help those who come to the source code later
   in ways that tests may not.
   You: That's why we pair program.
   Michael: What if all the developers who worked on the project are long
   gone?
   You: Read the tests.
 
  That's misrepresenting the thread. This is more accurate:
 
  Me: Don't use comments, use tests.
  Cutter: Noobs can't read tests
  Me: That's why we pair program.
  Michael: What do *you* do if all the developers who worked on the project
  are long gone?
  You: Read the tests. (implication; I'm not a noob).

 No, I think that's less representative than what I wrote:

 Cutter, me: Comments can help those who come to the source code later
 in ways that tests may not.

 Note the me there. Cutter mentioned noobs, I mentioned ways that
 comments provide information that tests don't. Again, I specified two
 cases where tests and pair programming wouldn't solve problems I had,
 and comments could. These are actual cases from my own personal
 experience in the last couple of weeks. If I accepted your answers at
 face value, they would contradict my personal experience from these
 two cases.

 Look, I think that TDD is great. And I think that pair programming is
 great, although it's not an option for many work environments.
 Everybody should do these things if they can, and they will solve more
 problems than comments would. But you have said, basically, that there
 is NO POSSIBLE CASE where comments can solve a problem that TDD and
 pair programming can't, and I think that's going to contradict many
 people's experiences. That's a pretty absolutist position. Hell, I
 suspect that if I asked Kent Beck himself, he'd say there are still
 some cases where comments provide value that TDD doesn't.

 Dave Watts, CTO, Fig Leaf Software
 http://www.figleaf.com/
 http://training.figleaf.com/

 Fig Leaf Software is a Veteran-Owned Small Business (VOSB) on
 GSA Schedule, and provides the highest caliber vendor-authorized
 instruction at our training centers, online, or onsite.

 

~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350183
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


Re: Remove all CF comments

2012-03-01 Thread Andrew Scott

First to the original poster, there is a way to do this but I would be
asking why you would want to first. With comments being used for annotated
validation for hyrule, to annotated comments for ORM.  If it is just to
purely find code that has been commented out, and needs removing then a
search and look method is perhaps the best option.

Secondly to the argument of TDD and comments. Let me first clear up that
TDD and BDD and tests in general, are there to code coverage our code. So
that there is no unexpected problems in the future, TDD and BDD are
primarily for input and output. That doesn't mean you can't comment on the
tests to say what ever you like to say.

But tests will not cover the likes of known bugs and work around's to
achieve such results, Now I have comments that as stated above are for
annotated validation for hyrule. And although they are tested through TDD,
they are still comments.

Secondly, I have rest / web services that describe what is being returned
from third parties. These are not covered by tests and my part as it is not
my code, but the comments make it very clear what is returned in the body
of the function. In that example the calls to the rest and web services,
are not affecting the final output of the result returned, where tests
cover that. But it does let the developer know that while in there making
changes they can see the expected results and any further outcomes to the
code.

Sorry but I am on the side that comments are a big and necessary thing,
that even I will admit to not doing enough off, but required in more cases
than not.

TDD is not the place to dictate why something was written the way it was
written, its job is to secure and pass on anything that is / might be
passed into that is not expected and cope with a return result. How would
these tests know why I wrote certain code the way that I did, because of
trying to get around a known issue? Would I place that comment in the
tests, no I would not, the comment is related to the way the function
behaves and not if it passes or fails because someone wants to ignore the
comments.


-- 
Regards,
Andrew Scott
WebSite: http://www.andyscott.id.au/
Google+: http://plus.google.com/108193156965451149543


~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350184
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


Re: Remove all CF comments

2012-03-01 Thread Raymond Camden

Mike, some arguments are comments are:

1) Repeats what's already obvious. For example:

!--- Loops over my crap ---
cfloop index=x from=1 to=#arrayLen(crap)#

2) Easy to become outdated.
For example, a comment that says something like, This hunts for bears
using a shotgun whereas the code was modified to hunt for bears using
blunt toothpicks. Maybe another developer made that change and simply
didn't feel like updating the code.

The book, Clean Code
(http://www.amazon.com/Clean-Code-Handbook-Software-Craftsmanship/dp/0132350882),
has a whole chapter on it.

Now to be clear, I don't actually agree with all the points. I'm Pro
Comment, just sharing some reasons why.

On Thu, Mar 1, 2012 at 9:34 AM, Mike Kear afpwebwo...@gmail.com wrote:

 I dont understand what's the problem with comments anyway.    So what if we
 have comments peppered through the code?    Do they slow down processing in
 any significant way?    Yes, they cause the files to be somewhat larger,
 but if all that means is a bit more disk space gets used,  so what?    If
 they reduce maintenance cost because its quicker for other developers to
 maintain the code later on, that must surely more than offset any overhead
 due to the existence of comments.


-- 
===
Raymond Camden, Adobe Developer Evangelist

Email : raymondcam...@gmail.com
Blog : www.raymondcamden.com
Twitter: cfj

~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350185
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


Re: Remove all CF comments

2012-03-01 Thread Russ Michaels

I have certainly seen my fair share of bad comments.
commented out comments.
blocks of code which have been commented out and disabled but the comments
are still there for that disabled code and have not been updated.
comments for code which no longer exists.

but it all comes down to the same thing really, poor documentation and
commenting, regardless of the end result.

I tend to put very simple comments in code, for anything major or for apps
that were likley to be maintained by someone else  I wrote documentation
and refer to that in the code using in page header comments.

On Thu, Mar 1, 2012 at 4:15 PM, Raymond Camden raymondcam...@gmail.comwrote:


 Mike, some arguments are comments are:

 1) Repeats what's already obvious. For example:

 !--- Loops over my crap ---
 cfloop index=x from=1 to=#arrayLen(crap)#

 2) Easy to become outdated.
 For example, a comment that says something like, This hunts for bears
 using a shotgun whereas the code was modified to hunt for bears using
 blunt toothpicks. Maybe another developer made that change and simply
 didn't feel like updating the code.

 The book, Clean Code
 (
 http://www.amazon.com/Clean-Code-Handbook-Software-Craftsmanship/dp/0132350882
 ),
 has a whole chapter on it.

 Now to be clear, I don't actually agree with all the points. I'm Pro
 Comment, just sharing some reasons why.

 On Thu, Mar 1, 2012 at 9:34 AM, Mike Kear afpwebwo...@gmail.com wrote:
 
  I dont understand what's the problem with comments anyway.So what if
 we
  have comments peppered through the code?Do they slow down processing
 in
  any significant way?Yes, they cause the files to be somewhat larger,
  but if all that means is a bit more disk space gets used,  so what?If
  they reduce maintenance cost because its quicker for other developers to
  maintain the code later on, that must surely more than offset any
 overhead
  due to the existence of comments.
 

 --
 ===
 Raymond Camden, Adobe Developer Evangelist

 Email : raymondcam...@gmail.com
 Blog : www.raymondcamden.com
 Twitter: cfj

 

~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350186
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


Re: XML and unicode: 0x1a

2012-03-01 Thread Ken Hammond

I don't want to sound stupid but how does regex work?  I could use something 
similar to this and always fall flat on my face every time someone mentions 
regex… 

Ken Hammond

IT Director
The Salem Group
Phone: 630-873-3018
Fax: 630-932-7010
Email: khamm...@saleminc.com

www.saleminc.com




On Feb 23, 2012, at 1:04 PM, Leigh wrote:

 
 Have you tried a regex replace of \x1a ? It *might* work. Worth a shot 
 anyway.
 
  
 -Leigh
 
 

~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350187
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


CFinclude issues

2012-03-01 Thread Eileen Harberts

I am trying to code a cfinclude on a template page:

cfinclude template=../includes/sponsors.cfm

to show this include when its pages are displayed.  The name of the include is 
correct, the location it is directing to is correct, but it will not work.  
Does someone have an easy solution to help me?

~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350188
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


RE: CFinclude issues

2012-03-01 Thread Bill Franklin

Are you sure you need the .. in front of the first slash?  It could be a 
relative path issue.  What errors are you getting?

Best regards,
 
Bill Franklin


-Original Message-
From: Eileen Harberts [mailto:eil...@tdai.net] 
Sent: Thursday, March 01, 2012 3:16 PM
To: cf-talk
Subject: CFinclude issues


I am trying to code a cfinclude on a template page:

cfinclude template=../includes/sponsors.cfm

to show this include when its pages are displayed.  The name of the include is 
correct, the location it is directing to is correct, but it will not work.  
Does someone have an easy solution to help me?



~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350189
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm


Re: CFinclude issues

2012-03-01 Thread Russ Michaels

What do you meanby it does not work, is there an error, the file is not
included, what?

Regards
Russ Michaels
From my mobile
On 1 Mar 2012 21:16, Eileen Harberts eil...@tdai.net wrote:


 I am trying to code a cfinclude on a template page:

 cfinclude template=../includes/sponsors.cfm

 to show this include when its pages are displayed.  The name of the
 include is correct, the location it is directing to is correct, but it will
 not work.  Does someone have an easy solution to help me?

 

~|
Order the Adobe Coldfusion Anthology now!
http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion
Archive: 
http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:350190
Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm
Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm