Beefy Boxes and Bandwidth Generously Provided by pair Networks
Perl Monk, Perl Meditation
 
PerlMonks  

comment on

( [id://3333]=superdoc: print w/replies, xml ) Need Help??

I do a fair amount of assembly programming with x86 and 8051 family, and have experience in about 20 different major processor families. My *biggest* peeve is people who refuse to put the name and version of the tool chain used to build the product in the source file (not to mention whether they used NMAKE, DMAKE or TMAKE under DOS/Win32).

As you may or may not know, for any given processor, there are a number of different assemblers. *Generally* the processor instructions remain the same, but the pseudop-ops (for macros, page ejects, equates, etc) often differ. Someone sends you a source file, and you have no idea what tool was used to assemble it. Sometimes, when you have a lot of experience, you can recognize "Oh, it's MASM, or TASM, or OPTASM". Many times though, especially if it was someone who used one of the 50+ freeware assemblers, you'd have better luck rolling dice.

I'm guilty of not doing that for Perl code. Luckily, Perl is a lot more portable than assembly source code is. On the other hand, people can use 5.6-isms that someone who doesn't use 5.6 may not recognize.

I always list the tool chain for my Forth, ASM, and 'C'-ware. I think I shall start at least indicating what it was run under when I wrote it, for my Perl scripts.

--Chris

e-mail jcwren

In reply to (jcwren) Re: Danger, danger Will Robinson (documenting code) by jcwren
in thread Danger, danger Will Robinson (documenting code) by jepri

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post; it's "PerlMonks-approved HTML":



  • Are you posting in the right place? Check out Where do I post X? to know for sure.
  • Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
    <code> <a> <b> <big> <blockquote> <br /> <dd> <dl> <dt> <em> <font> <h1> <h2> <h3> <h4> <h5> <h6> <hr /> <i> <li> <nbsp> <ol> <p> <small> <strike> <strong> <sub> <sup> <table> <td> <th> <tr> <tt> <u> <ul>
  • Snippets of code should be wrapped in <code> tags not <pre> tags. In fact, <pre> tags should generally be avoided. If they must be used, extreme care should be taken to ensure that their contents do not have long lines (<70 chars), in order to prevent horizontal scrolling (and possible janitor intervention).
  • Want more info? How to link or How to display code and escape characters are good places to start.
Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others wandering the Monastery: (3)
As of 2024-03-29 02:16 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found