OSDev.org

The Place to Start for Operating System Developers
It is currently Tue Mar 19, 2024 1:54 am

All times are UTC - 6 hours




Post new topic Reply to topic  [ 51 posts ]  Go to page Previous  1, 2, 3, 4
Author Message
 Post subject: Re: Wiki manual of style
PostPosted: Mon Dec 21, 2009 2:35 am 
Offline
Member
Member
User avatar

Joined: Sun Oct 22, 2006 7:01 am
Posts: 2646
Location: Devon, UK
Hi,

nedbrek wrote:
Sorry, I'm not trying to troll. It honestly does bug me.


Why should the entire wiki style be changed just because it annoys you? We do have other users. The official decision has been made on how to deal with the English used on the wiki.

End of subject, please.

Cheers,
Adam


Top
 Profile  
 
 Post subject: Re: Wiki manual of style
PostPosted: Wed Aug 29, 2018 8:38 pm 
Offline
User avatar

Joined: Thu Jul 19, 2018 9:40 pm
Posts: 24
I'm gonna assume that this thread is fine to revive considering the topic..

Can we have a wiki-wide assembly syntax choice? It would seem to be AT&T but I still see Intel style in places. (and if it is AT&T, may I spark the debate of changing it to Intel)

IMO it should be Intel, AT&T style gives me a headache when trying to read code in it :oops:.
AT&T is GCC default, but then most other assemblers use Intel, as well as Wikipedia (as far as I've seen).
However, I do think that inline assembly should stay AT&T.


Top
 Profile  
 
 Post subject: Re: Wiki manual of style
PostPosted: Thu Aug 30, 2018 1:09 am 
Offline
Member
Member
User avatar

Joined: Sat Mar 31, 2012 3:07 am
Posts: 4591
Location: Chichester, UK
Terrible idea.

If you are serious about OS development you should be equally happy using Intel or AT&T syntax (and PwerPC, ARM, etc. assembler). If not, it's not rocket science. Take 5 minutes out to learn the differences.


Top
 Profile  
 
 Post subject: Re: Wiki manual of style
PostPosted: Thu Aug 30, 2018 11:07 am 
Offline
Member
Member
User avatar

Joined: Fri Oct 27, 2006 9:42 am
Posts: 1925
Location: Athens, GA, USA
Perhaps parallel texts might be sensible, similar to how I set up my (still unfinished, admittedly) updated user page on data structures in assembly language. Though as I mentioned when I started that page, it would be useful if the Tabbed Tables plugin for Mediawiki were installed, but I doubt that the admins would want to take the trouble to do that just for that one use case.

However, for pages which are specific to x86 (i.e., almost all of them on this wiki), the differences between the code samples as given in AT&T syntax and Intel syntax isn't really enough to justify that.

Honestly, while the differences between those two syntax styles are pretty fundamental, in many cases the differences in syntax between different Intel-style assemblers (e.g., MASM, NASM, FASM, and YASM) are just as significant for the things the code examples are meant to demonstrate, especially if any data structures or macros are involved.

_________________
Rev. First Speaker Schol-R-LEA;2 LCF ELF JAM POEE KoR KCO PPWMTF
Ordo OS Project
Lisp programmers tend to seem very odd to outsiders, just like anyone else who has had a religious experience they can't quite explain to others.


Top
 Profile  
 
 Post subject: Re: Wiki manual of style
PostPosted: Thu Aug 30, 2018 3:06 pm 
Offline
User avatar

Joined: Thu Jul 19, 2018 9:40 pm
Posts: 24
iansjack wrote:
Terrible idea.

If you are serious about OS development you should be equally happy using Intel or AT&T syntax (and PwerPC, ARM, etc. assembler). If not, it's not rocket science. Take 5 minutes out to learn the differences.

Oh I know the differences, and I can read/write both, but I just think that having a same style for everything makes sense. Being equally happy is a hard thing to do when humans inherently prefer some things to others.

(I just reread your text that in fourth person:)
Fair enough though, I understand your point


Top
 Profile  
 
 Post subject: Requesting new <source> language
PostPosted: Wed Jan 31, 2024 9:05 am 
Offline
Member
Member
User avatar

Joined: Mon May 22, 2017 5:56 am
Posts: 811
Location: Hyperspace
I'd like to use <source> blocks for the "plain English" code of the CAL compiler; <source lang="CAL">. Preserving newlines is good style for this language and necessary for comments, so I'm using <pre> tags, but I could use syntax highlighting for comments. The only highlighting wanted is to color text from a single backslash to the end of the line in comment color. (This is all the IDE does.)

If it's convenient, it would be nice if the source were shown in the regular proportional font, but it's not necessary at all.

Here is an example of CAL code on the wiki:
https://wiki.osdev.org/Plain_English_Pr ... uage_issue

_________________
Kaph — a modular OS intended to be easy and fun to administer and code for.
"May wisdom, fun, and the greater good shine forth in all your work." — Leo Brodie


Top
 Profile  
 
Display posts from previous:  Sort by  
Post new topic Reply to topic  [ 51 posts ]  Go to page Previous  1, 2, 3, 4

All times are UTC - 6 hours


Who is online

Users browsing this forum: No registered users and 4 guests


You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Search for:
Jump to:  
Powered by phpBB © 2000, 2002, 2005, 2007 phpBB Group