C-tutorial

[slaeshjag]

Jag och en polare (mest polaren, men jag tar gärna credz ) har under en tid sporadiskt skrivit på en PC-inriktad nybörjarguide till C, på Svenska. Visst är engelska ändå rätt viktigt att kunna i sammanhanget, men w/e

Länk

Och något vi verkligen behöver är feedback. Är några delar otydliga? Missar vi att informera om vanliga fall gropar etc? Har vi missat något stort? Allt sånt är bra för oss att veta om vi ska kunna finslipa den till det bättre. Mer kommer vartefter vi har tid/ork. Förslag mottages också varmt. Språk är dock inte lika nödvändigt att påpeka, vi har en språkfacist som ska städa upp sådant, så fort han får tummen ur...


...Och ligger den fel får jag ursäkta mig, man blir lite dimmig i huvudet av att programmera GUI's i en texteditor

[Chaos]

Om man INTE vill att folk skall läsa, så väljer man svart bakgrund och grå text

[slaeshjag]

Justerade CSS'en något. Bättre?

[Chaos]

Bättre? Ja, men jag ifrågasätter starkt varför man väljer en svart bakgrund till text.

Gör ni det här enbart för er själva så, visst.

Vill ni att andra ska läsa så tänk om. Titta på hur andra sidor ser ut som är behagliga att läsa och surfa runt i, och då menar jag inte privata hemsidor för där finns hur mycket skit som helst.

Tyvärr handlar den här kritiken bara om utseendet/färgsättningen. Jag kommer inte att läsa något så länge det ser ut som det gör.

[slaeshjag]

Är det någon mer som uppfattar nuvarande färgsättningen som ett problem? Själv kör jag för det mesta överride på de flesta hemsidors färger för att jag själv ser bara gegga mot ljus bakgrund. Men är det verkligen så att det (för fler än bara Chaos) är ett problem att färgsättningen motverkar användbarheten av den, så ska ett helt nytt färgtema helt klart övervägas.

[bearing]

Jag tycker personligen att mörk bakgrund är behagligt. Det kanske beror på datoruppväxten i MS-DOS.

[MiSTer]

Mycket bra!
Tycker att det är behagligt att läsa med de färger som är... även de som var...

Det är inte kul att läsa något och sen upptäcka att man är snöblind...

[Housepainter]

Färgerna är bra nu! Skall läsa igenom vid senare tillfälle och se om jag kan lära mig något!

[danielr112]

färgerna är behagliga.

[Icecap]

Lite klen kontrast på färgen men OK, det går att läst. Jag undrar dock över hur ni har tänkt: C-tutorial på svenska...
Heter det då "tutorial" på svenska?
Heter det "Appendices" på svenska?
Heter det "Cheat sheet" på svenska?

Och det nyttar inte att fråga mig vad det ska stå istället, jag är inte svensk, däremot pratar och skriver jag flytande teknisk engelsk då det är "livsviktigt" i det jobb jag har. Men vill ni vara svenska i detta ska ni väl vara det också eller hur? Svengelska är ingen tjänat med.

Ni verkar utgå ifrån att alla kan engelska men vill ha det förklarat på svenska och då kommer dessa "bloopers".

[sodjan]

Jag har kollat igenom lite snabbt och hittat några saker som
jag tror är lätta att fixa.

Generellt:

- Håller med Icecap om onödiga engelska uttryck. Använd rellevanta svenska uttryck där sådana finns.
- Undvik uttryck som "extremt populärt", "extremt kraftfullt", "otroligt många" o.s.v. Det låter mest larvigt.

"Absoluta grunderna" :

- "Programmen som skrivs i C är gärna små och snabba." Oklart vad som menas.
- "programmeringstänket". Kanske inte ett helt bra uttryck.
- "standardiserat högnivåspråk". Råder en viss oenighet kring "högnivå", skriv gärna bara "språk".
- "...skulle portas till en nyare dator". Inte bara "nyare" dator...

"Variabler" :

> int heltal, tal2;
> heltal = 13;
> tal2 = heltal + 14;

Tydligare hade varit t.ex :
> int tal1, tal2;
> tal1 = 13;
> tal2 = tal1 + 14;

Eftersom "heltal" är en svensk översättning av varabelypen "int", så är
det inte helt lyckat som variabelnamn, även om det i princip inte är fel.

Av samma anledning tycker jag inte att "variabel" är ett bra namn på en
variabel, så som det används lite längre ner i ett annat exempel. "variabel1"
eller liknande är ganska OK, men "Tal1", "MinVariabel1" eller liknande är bättre
så att namnet klart avviker från övriga begrepp och definitioner.

- "Första nya här är initialiseringen sker av två variabler samtidigt, kommaseparerade."

Jag antar att det som avses ovan är (typ-) definitionen av variablerna.
Initieringen av en av dessa variabler sker på redan efter.
Med initiering avses (normalt) då en variabel får sin start/initial värde.

"if-satser"

- "If utför något konditionellt...".
"Villkorat" kanske är ett vanligare uttryck.

- "Ganska grundläggande, men hemskt användbart".
Så hemskt är det väl inte... ?

"char-typen" :

- "Det finns en till typ som är tänkt för att lagra bokstäver, nämligen char."
Inte bara för att lagra just bokstäver...

"Strängar, grunder" :

- "En sträng är en serie bokstäver som hör ihop."
Även här inte bara för bokstäver...

[cobree]

Hej skönt med en tutorial på svenska, det jag saknade är struct i eran tutorial och varför är att jag fått ett problem med sdcc och följande kod:

struct RFConfig
{
unsigned char n;
unsigned char buf[15];
};

typedef struct RFConfig RFConfig;

#define ADDR_INDEX 8 // Index to address bytes in RFConfig.buf
#define ADDR_COUNT 4 // Number of address bytes

const RFConfig txconf =
{
15,
0x08, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x12, 0x34, 0x56, 0x78, 0x83, 0x6c, 0x04
};

const RFConfig rxconf =
{
15,
0x08, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x87, 0x65, 0x43, 0x21, 0x83, 0x6c, 0x05
};

Det den larmar på är att det saknas {} vid deklaration av txconf och rxconf varför?
Detta är nog bara unikt med sdcc kompilatorn den skall funka med keil.

[sodjan]

Posta gärna det specifika felmeddelandet (och naturligstvis
i en egen tråd, denna tråd handlar om en tutorial...)
Jag lyckas inte få något fel vid en enkel testkompilering,
i och för sig inte med sdcc men i alla fall...

[slaeshjag]

Sodjan, det är precis den typen av kritik vi behöver! Att fixa till kommer troligtvis dröja några dagar, då jag har ett annat mjukvaruprojekt jag är på tok för taggad på för att riskera tappa lusten pga. göra annat, men vi behöver mer kritik i den klassen! Gärna också på de senare delarna.

[sodjan]

Jag hoppade över de senare delarna, antingen var det inget som jag
fastnade för eller så var det i stort samma "kritik", jag minns inte...

Om jag ska ge ett generellt omdöme så blir det lite i stil med att det ser
ut som man kan förvänta sig av något skrivet av någon som nog har en
bra inblick i just de tekniska delarna, men som kanske saknar en del
vana/erfarenhet av att skriva bra och lättläst text (speciellt riktat
till nybörjare inom det aktuella området). Det handlar dels om de
"svengelska" uttrycken men även den lite för stora användningen
(i mitt tycke) av uttryck som "extremt" o.s.v.

Sen så ser jag inte riktigt vad som gör denna introduktion till C
bättre än att gå till biblioteket och låna en nybörjarbok i C.

En annan lite sak...
Era sidorna med "Övrningar" och "Facit" är inte radbrytna.
Jag får scrolla vänter/höger som fasen för att se all text.
Men jag antar att de ska flyttas in från TXT filerna till HTML
fierna så att de får en bättre formattering.

Några småsaker ur "ordlistan"...

> initialisering (eg. deklarering) - declaration

Jag tror nog inte att det handlar om initiering, det görs på annat sätt.
(Jag är dock osäker på om initialisering eller initiering är korrekt, båda
används för att beskriva samma sak, att ge en variabel ett utgångs/start
värde.)

> vertikalt streck - pipe

Hm, "pipe" är väl snarare den funktion som det aktuella tecknet har i
vissa operativsystem och CLI'er. Inte namnet på tecknet i sig !?
"vertical bar" eller liknande är nog en bättre generell översättning.

> villkor (eg. uttryck) - expression

"villkor" och "uttryck" är nog inte samma sak.
"c = a + b" är ett uttryck, men det är ju inte något villkor...