[v4] Corrections & Améliorations de la doc FR

RegisLG · Message par **RegisLG** » lun. 29/mai/2006 16:19

Salut tt le monde, j'ai mis à jour la page 1 (bizarement je ne recevais plus les mails prévenant de nouveaux posts dans ce topic).

nico · Message par **nico** » lun. 29/mai/2006 16:39

Comtois,

Serait il possible d'avoir lea liste des constantes de PB dans le fichier d'aide?

comtois · Message par **comtois** » lun. 29/mai/2006 17:09

nico a écrit :Comtois,

Serait il possible d'avoir lea liste des constantes de PB dans le fichier d'aide?

Je voudrais bien , mais je peux point

Voici ce que disait André ou Freak ( je ne sais pas qui a fait la page)

used the great new DocMaker (by André output module to add a often wished PB constants list with links to their relating commands
(english + german done, for french the DocMaker locale strings must be updated first)

Je ne sais pas en quoi consiste "the DocMaker locale strings" , je n'ai pas le nouveau Docmaker , il va falloir attendre un peu.

RegisLG , effectivement @Green, @Orange, @Red sont de nouveaux mots clefs , c'est une bonne idée pour repérer rapidement les modifs.
Idem je n'ai pas le nouveau DocMaker pour sortir une doc à jour.

RegisLG · Message par **RegisLG** » lun. 29/mai/2006 17:48

comtois a écrit :Voici ce que disait André ou Freak ( je ne sais pas qui a fait la page)
used the great new DocMaker (by André output module to add a often wished PB constants list with links to their relating commands
(english + german done, for french the DocMaker locale strings must be updated first)
Je ne sais pas en quoi consiste "the DocMaker locale strings" , je n'ai pas le nouveau Docmaker , il va falloir attendre un peu.

Où as-tu lu ce passage stp ?

comtois · Message par **comtois** » lun. 29/mai/2006 18:03

dans un mail .

Comme je te l'expliquais il y a quelques semaines, pour chaque modif du cvs un mail est envoyé.

Ulix · Message par **Ulix** » mar. 30/mai/2006 22:03

Une petite coquille

Aide, instruction : DIM

Pour effacer le contenu complet d'un tableu et libérer la mémoire qu'il occupe, appeler Dim avec 0 éléments.

tableu => tableau

Merci d'avance

comtois · Message par **comtois** » mer. 31/mai/2006 8:30

c'est fait mais pas encore diffusé, j'attends le nouveau DocMaker .

Et j'ai aussi mis 0 élément

comtois · Message par **comtois** » sam. 03/juin/2006 20:27

Bien que je n'ai pas le dernier Docmaker , je viens tout de même de mettre en ligne la dernière doc à jour.

Désolé il n'y a pas encore les constantes de PB

De mémoire , les corrections concernent principalement le fichier gadget.

Quelques corrections de syntaxe, il restait des paramètres en anglais dans certaines commandes, et il manquait l'option pour une ou deux commandes.

Pour certaines commandes l'information sur la gestion des couleurs était incomplète voire manquante.

Ajout de SpinGadget() dans l'aide de EventType().

Pour Ulix , la correction de la page DIM.

Bref des broutilles et c'est toujours disponible à la même adresse.

RegisLG · Message par **RegisLG** » dim. 04/juin/2006 0:49

Dans 2ddrawing, pour fillarea() il manque l'image fillarea.png

comtois · Message par **comtois** » dim. 04/juin/2006 10:57

RegisLG a écrit :Dans 2ddrawing, pour fillarea() il manque l'image fillarea.png

oui j'ai envoyé un mp à André pour lui signaler (je suppose que c'est lui qui a ajouté le lien vers l'image, je le laisse aller au bout de son idée).Peut-être qu'il jugera utile de modifier l'exemple pour réduire la taille de l'image.
Quand j'ai fait l'exemple je n'avais pas pensé à créer une image

J'ai complété le fichier Image (ajout de quelques liens dans loadimage et createimage)

Sinon j'ai vu que la page des constantes PB pour la doc française était faite

Du coup j'ai mis en ligne la nouvelle doc qui intègre cette fameuse liste.

Remarque : Comme la liste est générée avec DocMaker, ça serait intéressant de comparer la liste française avec la liste anglaise pour voir s'il ne manquerait pas quelques infos dans notre doc

est-ce qu'il y a un courageux pour faire une moulinette pour comparer ? ou comparer à l'oeil par échantillonnage ?

la doc est toujours à la même adresse.

Dräc · Message par **Dräc** » dim. 04/juin/2006 11:32

Si je puis me permettre, afin de ne pas rechercher l’adresse de la doc dans les méandres de cette rubrique (elle commence à être conséquente), je vous propose d’ajouter un lien dans votre signature à RegisLG et toi…

comtois · Message par **comtois** » dim. 04/juin/2006 11:58

je n'ai plus de place dans ma signature

L'adresse est toujours indiquée dans le premier post .

à l'avenir je ne dirai plus que la doc peut être trouvée à la même adresse , je mettrai directement le lien

donc la doc se trouve ici :

http://perso.wanadoo.fr/comtois/Doc/PureBasic.chm

Dräc · Message par **Dräc** » dim. 04/juin/2006 12:17

C'est vrai, la premiere page! En plus elle est réactualisée.
Tu vois, à force je l'avais oubliée...

RegisLG · Message par **RegisLG** » dim. 04/juin/2006 12:58

comtois est-ce que tu as "bidouillé" pour intégrer la liste des constantes dans la doc ?

Pour l'instant je fais ça:
compilation normale avec DocMaker,
copie manuelle du 'pbconstants.html' dans le dossier reference de la doc compilee,
et recompilation.

sinon cette page n'est pas insérée.
-----

Concernant les différences dans la liste des constantes, j'ai trouvé ces erreurs dans la doc + quelques coquilles :

Reference\ide_help.txt
coquille, le texte n'est pas entièrement en gras => Le "Microsoft Plateform SDK"

Engine3D.txt
Add3DArchive()
Insérer linebreak pour séparer les paragraphes (cf version anglaise)
Origine d'une erreur de référencement pour #PB_3DArchive + #PB_3DArchive_Zip :
Balises '@ConstantColor' manquantes devant les noms de constantes :

#PB_3DArchive_FileSystem ; Répertoire classique, situé sur une unité disque
#PB_3DArchive_Zip

Gadget.txt
DateGadget()
coquille : mette => mettre

Généralités
Origine d'une erreur de référencement pour #PB_Any :
Traduction manquante (et donc les balises '@ConstantColor' sont absentes)

@LineBreak
@LineBreak
Before using gadgets there will be normally opened a @Link "Window/OpenWindow" "window" first,
furthermore there will be often used @LibraryLink "Menu" "menus", @LibraryLink "ToolBar" "toolbars"
and @LibraryLink "StatusBar" "statusbars" when creating graphical user interfaces.
@linebreak
@linebreak
The commands that create a new gadget return the new gadget number (called #Gadget in this library)
if @ConstantColor "#PB_Any" was used to create the gadget. If a static number was given to identify
the gadget instead of @ConstantColor "#PB_Any", then the commands return the OS identifier for the
created Gadget.

@OS Windows
These OS identifiers (or also called handles) can be used for other PureBasic functions, as well for
WinAPI commands like SendMessage_() etc. Look at the chapter @ReferenceLink "handles" "Handles and Numbers"
in the reference manual for more information.

CreateGadgetList()
Origine d'une erreur de référencement pour #PB_Any :
Traduction manquante

Or use the
new @ReferenceLink "purebasic_objects" "#PB_Any" constant as 'GadgetID'.

SetGadgetItemState()
Origine d'une erreur de référencement pour #PB_Calendar_Normal :
Il manque la balise @ConstantColor devant #PB_Calendar_Normal

GetGadgetState() et SetGadgetState()
Origine d'une erreur de référencement pour #PB_Date_CheckBox (redondance) :
Corriger la casse : #PB_Date_Checkbox en #PB_Date_CheckBox
sinon la liste des mots-clefs référence 2 mots-clefs différents au lieu d'un.

GetGadgetItemState()
Les guillemets n'ont pas été fermés après les noms de constantes, cela crée de fausses entrées dans la liste des constantes.

@ConstantColor "#PB_Explorer_File : L'élément est un fichier.
@ConstantColor "#PB_Explorer_Directory: L'élément est un répertoire (ou un disque).
@ConstantColor "#PB_Explorer_Selected : L'élément est sélectionné.

MDIGadget()
Constante non référencée
Oubli du symbole # devant la constante PB_Gadget_BackColor

Sprite.txt
UseBuffer()
Liens hypertexte manquants pour : DisplaySprite(), DisplayTransparentSprite()
Origine d'une erreur de référencement pour #PB_Default
Erreur de traduction (+ insérer @ConstantColor) sur

To get back on the main screen buffer, use #PB_Default (= -1) as #Sprite value.

Window.txt
WindowEvent()
Origine d'une erreur de référencement pour toutes les constantes ci-dessous
#PB_Event_Menu
#PB_Event_Gadget
#PB_Event_CloseWindow
#PB_Event_Repaint
#PB_Event_MoveWindow
#PB_Event_SizeWindow
#PB_Event_ActivateWindow
Il manque les balises @ConstantColor devant les constantes.

Requester.txt
MessageRequester
Passage manquant (et donc constantes non référencées) :

Possible return values are following constants:
#PB_MessageRequester_Yes : the 'yes' button was pressed
#PB_MessageRequester_No : the 'no' button was pressed
#PB_MessageRequester_Cancel : the 'Cancel' button was pressed

Network.txt
SendNetworkString
Passage manquant (et donc constantes non référencées) :

Note: There is no ReceiveNetworkString(), SendNetworkString() only provides a solution to quickly send strings. The string will be sent as raw data (without the terminating NULL character), so it can be received using ReceiveNetworkData(), after NetworkServerEvent() / NetworkClientEvent() returned #PB_NetworkEvent_Data).
Process.txt
ReadProgramError()
Erreur sur le nom de la constante !!!
Dans la version anglaise : the #PB_Program_Error flag
Dans la version française : l'option #PB_Program_Read

Sprite.txt
CreateSprite
Origine d'une erreur de référencement pour toutes les constantes ci-dessous
#PB_Sprite_Memory
#PB_Sprite_Alpha
#PB_Sprite_Texture

Il manque les balises @ConstantColor devant les constantes.
DisplayAlphaSprite()
erreur de traduction + lien hypertext manquant (manque 'loaded with LoadSprite()')
Il manque la balise @ConstantColor devant #PB_Sprite_Alpha
DisplayShadowSprite()
erreur de traduction + lien hypertext manquant (manque 'loaded with LoadSprite()')
Il manque la balise @ConstantColor devant #PB_Sprite_Alpha
DisplaySolidSprite()
erreur de traduction + mise en page + liens hypertext manquants (table couleur)
Il manque la balise @ConstantColor devant #PB_Sprite_Alpha
SpriteOutput()
Il manque la balise @ConstantColor devant #PB_Sprite_Alpha
CreateSprite3D()
erreur de traduction + mise en page + liens hypertext/traduction manquants
(balise @ConstantColor devant #PB_Sprite_Texture)

Reference\Handles
Origine d'une erreur de référencement pour #PB_Any :
Balises '@ConstantColor' manquantes devant les noms de constantes :
La plupart des fonctions qui créent ces objets renvoient cet identifiant comme résultat,
si tout s'est bien passé. Ceci est seulement le cas si #PB_Any n'a pas été utilisé pour créer l'objet.
Si #PB_Any est utilisé, ces fonctions renvoient le numéro de l'objet qui a été attribué par PB pour elles, mais pas l'identifiant.

RegisLG · Message par **RegisLG** » lun. 05/juin/2006 0:21

En cherchant les causes des erreurs de la liste des constantes, j'ai également trouvé des erreurs dans la doc anglaise.
Je les mets dans un post séparé pour éviter le mélange

Erreurs à signaler pour la doc ANGLAISE

strings.txt (#PB_Ascii) (#PB_UTF8)
StringByteLength()
Il faut remplacer : @ConstantColor "#PB_Ascii, #PB_UTF8"
par : @ConstantColor "#PB_Ascii", @ConstantColor "#PB_UTF8"
sinon les 2 mots-clefs sont référencés comme un seul mot-clé "#PB_Ascii, #PB_UTF8"

file.txt (#PB_Ascii) (#PB_UTF8)
ReadStringFormat()
Il faut remplacer : @ConstantColor "#PB_Ascii, #PB_UTF8"
par : @ConstantColor "#PB_Ascii", @ConstantColor "#PB_UTF8"
sinon les 2 mots-clefs sont référencés comme un seul mot-clé "#PB_Ascii, #PB_UTF8"
WriteStringFormat()
Il faut remplacer : @ConstantColor "#PB_Ascii, "#PB_UTF8"
par : @ConstantColor "#PB_Ascii", @ConstantColor "#PB_UTF8"
sinon les 2 mots-clefs sont référencés comme un seul mot-clé "#PB_Ascii, #PB_UTF8"

gadget.txt
GetGadgetItemState()
Il manque la balise @ConstantColor devant #PB_Calendar_Bold
Il manque la balise @ConstantColor devant #PB_Calendar_Normal
SetGadgetItemState()
Il manque la balise @ConstantColor devant #PB_Calendar_Bold
Il manque la balise @ConstantColor devant #PB_Calendar_Normal
Il manque la balise @ConstantColor devant #PB_ListIcon_CheckBoxes
CalendarGadget()
Il manque la balise @ConstantColor devant #PB_Calendar_Borderless
SetGadgetState()
Corriger la casse : #PB_Date_Checkbox en #PB_Date_CheckBox
sinon la liste des mots-clefs référence 2 mots-clefs différents au lieu d'un.
DateGadget()
Il manque la balise @ConstantColor devant #PB_Date_UpDown
SetGadgetFont()
Il manque la balise @ConstantColor devant #PB_Default
AddGadgetColumn()
Il manque la balise @ConstantColor devant #PB_EventType_Change
GetGadgetState()
Il manque la balise @ConstantColor devant #PB_Date_Checkbox
Il manque la balise @ConstantColor devant #PB_Explorer_File
Il manque la balise @ConstantColor devant #PB_Explorer_Directory
ExplorerTreeGadget()
#PB_Explorer_GridLines non mentionné (présent sur la doc FR)
TreeGadget()
Passage présent dans la doc FR et absent de la doc EN :

Ce gadget supporte les commandes SetGadgetColor() et GetGadgetColor() avec les valeurs 'TypeCouleur' suivantes:
#PB_Gadget_FrontColor: Couleur du texte
#PB_Gadget_BackColor : Couleur du fond
#PB_Gadget_LineColor : Couleur des lignes reliant les noeuds

Ce gadget supporte également les commandes SetGadgetItemColor() et GetGadgetItemColor() avec les valeurs 'TypeCouleur' suivantes:
#PB_Gadget_FrontColor: Texte de l'élément.
#PB_Gadget_BackColor : Fond de l'élément.

ListIconGadget()
Passage présent dans la doc FR et absent de la doc EN :

GetGadgetItemState(): Renvoie l'état de l'élément spécifié. Ce peut être une combinaison de #PB_ListIcon_Selected et #PB_ListIcon_Checked si les 'checkboxes' sont affichées
- SetGadgetItemState(): Change l'état de l'élément spécifié. Ce peut être une combinaison de #PB_ListIcon_Selected et #PB_ListIcon_Checked si les 'checkboxes' sont affichées

MDIGadget
Passage présent dans la doc FR et absent de la doc EN :

- SetGadgetAttribute(): Avec une des constantes suivantes:
#PB_ScrollArea_InnerWidth : Modifie la largeur (en pixels) de la zone interne du gadget.
#PB_ScrollArea_InnerHeight: Modifie la hauteur (en pixels) de la zone interne du gadget.

movie.txt
PlayMovie()
Il manque la balise @ConstantColor devant #PB_Movie_Rendered

process.Txt
WriteProgramString
#PB_Program_Eof non mentionné (présent sur la doc FR)
WriteProgramStringN
#PB_Program_Eof non mentionné (présent sur la doc FR)

toolbar.txt
GetToolBarButtonState() & SetToolBarButtonState()
Passage présent dans la doc FR et absent de la doc EN :

(utile pour les boutons utilisant l'option #PB_ToolBar_Toggle).