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

[meganet]

Salut, c'est vrai que c'est galère de devoir faire toutes les docs pour voir que rien ou presque ne change. Mais les petits changement, devrai (je pense) apparêtres avec indiqué pour quel OS ils sont. Et puisqu'on en parle, à quand la cross compilation?!!!
(Je sais j'en demande beaucoup!!!)

[comtois]

Dans l'aide de l'IDE , il y a ces passages à traduire :

@Section Examining variables during runtime

The value of a variable can be very quickly viewed while the program is running by placing the
mouse cursor over a variable in the sourcecode and waiting for a brief moment. If the variable is
currently in scope and can be displayed, its value will be shown as a tooltip on the mouse location.

@Image ide_debugger_showstructure.png


More complex @ReferenceLink "general_rules" "expressions" (for example @ReferenceLink "dim" "array" fields)
can be viewed by selecting them with the mouse and placing the mouse cursor over the selection.

@Image ide_debugger_showexpression.png


The @ReferenceLink "ide_debugtools" "debugger tools" also offer a number of ways to examine the content
of @ReferenceLink "variables" "variables", @ReferenceLink "dim" "arrays" or @LibraryLink "linkedlist" "linkedlists".

Concernant le débogueur indépendant

La zone d'affichage du code source est utilisée pour montrer la ligne en cours d'exécution
ainsi que les erreurs ou les points d'arrêt. La liste déroulante située au dessus permet de
sélectionner les différents fichiers composants le programme. Les boutons "Mettre point d'arrêt",
"Enlever point d'arret" et "Effacer points d'arrêt" permettent de gérer dynamiquement les points
d'arrêt dans le fichier source affiché. The code view also provides the mouse-over feature from the integrated
debugger to quickly view the content of a variable.

[comtois]

fichier ide_debugtools


concernant la fenêtre de debug

The entry field at the bottom of the window allows an expression to be entered, which
will be evaluated and the result printed in the output box. This allows to quickly check
the state of variables or array fields without the need to look them up in one of the
debugger tools. The evaluation is started by pressing Enter or clicking on the "Display" button.
If the expression cannot be evaluated for some reason, an errormessage is displayed
in the statusbar.

@LineBreak
@LineBreak

The expression can be any valid @ReferenceLink "general_rules" "PB expression" (not
including logical ones or containing @ReferenceLink "reference" "PB keywords").
It can contain @ReferenceLink "variables" "variables", @ReferenceLink "dim" "arrays",
@LibraryLink "LinkedList" "linked lists", @ReferenceLink "general_rules" "constants" and also some commands from the
@LibraryLink "Math" "Math", @LibraryLink "Memory" "Memory" and @LibraryLink "String" "String" libraries.

@Section The Profiler

; add image here

The profiler tool can count how often each line in the sourcecode is executed. This collected data
can be used to identify which portions of the code are used most often and where improvements make
most sense. It also helps to identify problems where a piece of the code is executed too often as
a result of an error.

@LineBreak
@LineBreak

@Bold "Recording the data"
@LineBreak
The recording of the data can be controlled by the Start, Stop and Reset (to set all counts to 0) buttons
in the profiler window. The Update button can be used to update the graph while the program is running.
Each time the program is halted or in step mode, the data is updated automatically. By default, the profiler
is recording data from the start of the program. This can be changed in the @ReferenceLink "ide_preferences" "Preferences".

@LineBreak
@LineBreak

@Bold "Examining the data"
@LineBreak
The recorded data is displayed as a graph, with the vertical axis showing the source line number and
the horizontal axis showing how often the lines were executed. If the running program consists of more
than one source file, a list of source files is presented below the graph. To display the graph for
a file either select it, or check its checkbox. Multiple files can be shown in the graph at once to better
compare them. Right-clicking on one of the filenames allows to change the color used to display that file in the graph.

@LineBreak
@LineBreak

@Bold "Mouse modes in the graph"
@LineBreak
Right-clicking inside the graph brings up a popupmenu which allows to zoom in or out or to show the source line
that was clicked on in the IDE or code display of the debugger. The action taken by a left-click can be controlled
by the buttons on the left side:
@LineBreak
@LineBreak

@FormatIf HTML

<table border=0 cellspacing=2>
<tr>
<td><img src="../HelpPictures/debugger_arrow.png"></td>
<td><font size=2>Left-clicking and dragging allows to scroll the graph display.</font></td>
</tr>
<tr>
<td><img src="../HelpPictures/debugger_select.png"></td>
<td><font size=2>Left-clicking and dragging allows to select an area which will be zoomed in.</font></td>
</tr>
<tr>
<td><img src="../HelpPictures/debugger_cross.png"></td>
<td><font size=2>While this button is activated, moving the mouse on the graph displays a crosshair to better identify the line and call count under the mouse.</font></td>
</tr>
<tr>
<td><img src="../HelpPictures/debugger_zoomin.png"></td>
<td><font size=2>Zoom in</font></td>
</tr>
<tr>
<td><img src="../HelpPictures/debugger_zoomout.png"></td>
<td><font size=2>Zoom out</font></td>
</tr>
<tr>
<td><img src="../HelpPictures/debugger_zoomall.png"></td>
<td><font size=2>Zoom out so all lines can be viewed</font></td>
</tr>
</table>

@FormatElse

- Arrow button: Left-clicking and dragging allows to scroll the graph display.
@LineBreak
- Box button: Left-clicking and dragging allows to select an area which will be zoomed in.
@LineBreak
- Cross button: While this button is activated, moving the mouse on the graph displays a crosshair to better identify the line and call count under the mouse.
@LineBreak
- Zoom buttons: These buttons allow to zoom in/out and zoom out so all lines can be viewed.

@FormatEndIF

The memory viewer lets you view a memory area in your program.
The range to view can be entered into the range fields as any valid PB expression.
(This can be a normal decimal value, a hex number preceeded by the '$' character
or any other valid expression, including variables or pointers from the code).
If the content of the second range field starts with a "+" sign, the content is
interpreted as relative to the first field.

Example: "*Buffer + 10" to "+30" will display the 30 bytes of memory starting
at the location 10 bytes after what *Buffer points to.


If the memory area is valid for viewing, it will be displayed in the area below.
If parts of the area are not valid for reading, you will get an error message.

[comtois]

Dans le fichier ide_preference

@Bold "Debug Output - Display debug output in the error log"
@LineBreak
With this option enabled, a @ReferenceLink "debugger" "Debug" command in the code will not
open the @ReferenceLink "ide_debugtools" "Debug Output window", but instead show the output in the @ReferenceLink "ide_start" "error log".


@Bold "Profiler - Start Profiler on program startup"
@LineBreak
Determines wether the profiler tool should start recording data when the program starts.

[Progi1984]

Dans l'aide de l'IDE , il y a ces passages à traduire :

@Section Examiner les variables durant l'exécution

La valeur d'une variable peut être rapidement observé pendant que le programme fonctionne en placant le curseur de la souris dans le code source et en attendant un bref instant. Si la variable est actuellement dans la possibilité d'être affiché, sa valeur sera affiché dans une infobulle à la position de la souris.

@Image ide_debugger_showstructure.png


Plus complexe, @ReferenceLink "general_rules" "les expressions" (par exemple, les champs des @ReferenceLink "dim" "tableaux" ) peuvent être vu en les sélectionnant avec la souris et en placant le curseur de la souris au dessus de la sélection.

@Image ide_debugger_showexpression.png


Les @ReferenceLink "ide_debugtools" "outils de débuggage" offrent aussi de nombreuses manières pour examiner le content des @ReferenceLink "variables" "variables", @ReferenceLink "dim" "tableaux" or @LibraryLink "linkedlist" "listes chainées".

Concernant le débogueur indépendant

La zone d'affichage du code source est utilisée pour montrer la ligne en cours d'exécution
ainsi que les erreurs ou les points d'arrêt. La liste déroulante située au dessus permet de
sélectionner les différents fichiers composants le programme. Les boutons "Mettre point d'arrêt",
"Enlever point d'arret" et "Effacer points d'arrêt" permettent de gérer dynamiquement les points
d'arrêt dans le fichier source affiché. La zone d'affichage du code fournit aussi la caractéristique de survolage de la souris à partir du débuggueur intégré pour voir rapidement le contenu d'une variable.

[Progi1984]

Dans le fichier ide_preference

@Bold "Sortie du Débuggage - Affiche la sortie du débuggagge dans le log d'erreur"
@LineBreak
Avec cette option activé, une commande @ReferenceLink "debugger" "Debug" dans le code n'ouvrira pas la @ReferenceLink "ide_debugtools" "fenêtre Debug Output", mais affichera la sortie dans le @ReferenceLink "ide_start" "log d'erreur".


@Bold "Profileur - Lancer le profileur au démarrage du programme"
@LineBreak
Détermine si l'outil de profilage commencera l'enregistrement des données quand le programme commencera.

[Progi1984]

fichier ide_debugtools
concernant la fenêtre de debug

Le champ de saisie au bas de la fenêtre permet d'entrer une expression, qui sera évalué et le résultat sera affiché dans la boîte de sortie. Cela permet de rapidement vérifier l'état de variables ou de champs de tableaux sans le besoin de les observer via les outils de débuggage. L'évaluation commence par l'appui du bouton Entrée ou en en cliquant sur le bouton "Afficher". Si l'expression ne peut être évaluer pour une quelconque raison, un message d'erreur est affiché dans la barre de statut.

@LineBreak
@LineBreak

L'expression peut être n'importe quel @ReferenceLink "general_rules" "expression" valide (excluant les expressions logiques ou celles containant des @ReferenceLink "reference" "mots clés PB"). Cela peut contenir des @ReferenceLink "variables" "variables", des @ReferenceLink "dim" "tableaux", des @LibraryLink "LinkedList" "listes chaînées", des @ReferenceLink "general_rules" "constantes" et aussi quelques commandes des librairies @LibraryLink "Math" "Math", @LibraryLink "Memory" "Mémory" and @LibraryLink "String" "String".

@Section Le profileur

; add image here

L'outil de profilage peut compter combien de fois chaque ligne du code source est exécuté. Ces données collectées peuvent être utilisées pour identifier quelles portions du code sont les plus souvent utilisées et quelles améliorations peuvent être fait dans ce sens. Cela aide aussi à identifier les problèmes où un morceau de code est exécuté trop souvent à la suite d'une erreur.

@LineBreak
@LineBreak

@Bold "Enregistrement des données"
@LineBreak
L'enregistrement des données peut être controllé par les boutons Lecture, Arrêt et Réinitialiser (pour mettre tous les compteurs à 0) dans la fenêtre du profileur. Le bouton Mise à jour peut être utilisé pour mettre à jour le graphique pendant que le programme fonctionne. Chaque fois que le programme est arrêté ou en mode pas-à-pas, les données sont mises à jour automatiquement. Par défaut, le profileur enregistre les données dés le début du programme. Cela peut être changé dans les @ReferenceLink "ide_preferences" "Préfèrences".

@LineBreak
@LineBreak

@Bold "Examen des données"
@LineBreak
Les données enregistrées sont affichées comme un graphique, avec l'axe vertical montrant le numéro de la ligne du code source et l'axe horizontal affichant combien de fois ces lignes ont été executé. Si le programme executé contient plus d'un fichier source, une liste de fichiers source est proposé au-dessus du graphique. Pour afficher le graphique pour un fichier, sélectionnez-le ou cochez sa case à cocher. De multiples fichiers peuvent être affiché sur le graphique à la fois pour mieux les comparer. Un clic droit sur un des fichiers permet de changer la couleur utilisé pour changer la couleur utilisé pour afficher ce fichier dans le graphique.

@LineBreak
@LineBreak

@Bold "Modes de la souris dans le graphique"
@LineBreak
Un clic droit dans le graphique affiche un menu contextuel qui permet de zoomer ou dézoomer pour afficher la ligne du code source qui a été cliqué dans l'IDE ou la zone d'affichage du code du débuggueur. L'action prise par un clic gauche peut être controllé par les boutons sur le côté gauche :
@LineBreak
@LineBreak

@FormatIf HTML

<table border=0 cellspacing=2>
<tr>
<td><img src="../HelpPictures/debugger_arrow.png"></td>
<td><font size=2>Clic gauche et Glisser permettent de défiler dans la zone d'affichage du graphique.</font></td>
</tr>
<tr>
<td><img src="../HelpPictures/debugger_select.png"></td>
<td><font size=2>Clic gauche et Glisser permettent de sélectionner une zone qui sera zoomé.</font></td>
</tr>
<tr>
<td><img src="../HelpPictures/debugger_cross.png"></td>
<td><font size=2>Tant que ce bouton est activé, dépalcer la souris sur le graphique affiche un curseur de type 'crosshair' pour mieux identifier la ligne et le compteur d'appels présents sous la souris.</font></td>
</tr>
<tr>
<td><img src="../HelpPictures/debugger_zoomin.png"></td>
<td><font size=2>Zoom avant</font></td>
</tr>
<tr>
<td><img src="../HelpPictures/debugger_zoomout.png"></td>
<td><font size=2>Zoom arrière</font></td>
</tr>
<tr>
<td><img src="../HelpPictures/debugger_zoomall.png"></td>
<td><font size=2>Zoom arrière de façon que toutes les lignes soient affichées</font></td>
</tr>
</table>

@FormatElse

- Bouton de type 'flêche': Clic gauche et Glisser permettent de défiler dans la zone d'affichage du graphique.
@LineBreak
- Bouton de type 'boîte' : Clic gauche et Glisser permettent de sélectionner une zone qui sera zoomé.
@LineBreak
- Bouton de type 'crosshair' : Tant que ce bouton est activé, dépalcer la souris sur le graphique affiche un curseur de type 'crosshair' pour mieux identifier la ligne et le compteur d'appels présents sous la souris.
@LineBreak
- Boutons de zoom : Ces boutons permettent de zoomer en avant/arrière et en arrière de façon que toutes les lignes soient affichées.

@FormatEndIF

Le visualisateur de mémoire vous permet de voir une zone mémoire dans votre programme. L'étendue peut être saisie dans les champs d'étendue comme n'importe quel expression PB. (Cela peut être une valeur décimal normale, un nombre hexadécimal précédé par le caractère '$' ou n'importe quelle autre expression valide, incluant des variables ou pointeurs à partir d'une code). Si le contenu de la seconde étendue comme par le signe "+", le contenu est interprété comme relatif au premier champ.

Exemple: "*Buffer + 10" à "+30" affichera les 30 premiers octets de la zone de mémoire commençant 10 octets après l'emplacement vers lequel *Buffer pointe.


Si la zone de mémoire est valide pour visualisation, cela sera affiché dans la zone en dessous. Si des parties de la zone ne sont pas valides pour lecture, vous obtiendrez un message d'erreur.

[comtois]

Je viens de corriger la bibio Sort (remplacement des nombres par des constantes PB pour sélectionner le type de tri souhaité pour les strings), idem pour ReplaceString(), et quelques bricoles.

Accès à la doc en ligne

Et j'ai aussi mis le fichier d'aide au format chm en ligne, vous pouvez le télécharger ici.

C'est la version la plus à jour.

[Ollivier]

P... je ne pouvais pas être plus mouché !

Une doc en ligne

[comtois]

comme vous l'avez remarqué, les messages d'erreur du compilo sont désormais en français (4.30). J'ai accès au fichier catalog, je peux donc corriger des fautes de frappes si vous en voyez. Idem pour le fichier de l'IDE, il est désormais dispo avec le reste de la doc, je peux le tenir à jour si vous voyez des améliorations.

[Anonyme2]

Documentation IDE PUreBasic

chapitre Outils de déboguage/Le Profileur

Enregistrement des données

L'enregistrement est contrôlé par les boutons placés dans la fenêtre du profileur : 'Start', 'Stop' et 'Reset' (pour tout initialiser). Le bouton 'Mise à jour' permet de mettre à jour le graphe pendant l'exécution du programme. Les données sont automatiquement mises à jour lorsque le programme est stoppé ou en mode pas à pas. Par défaut le profiler enregistre les données dès le début du programme mais cette option peut-être changée dans les

Il faut mettre en français le nom des boutons 'Start', 'Stop' et 'Reset' pour que cela corresponde à la fenêtre en français.

chapitre Compilation d'un programme
Requiert le mode utilisateur pour Windows Vista (Windows seulement)
Le chapitre est en anglais

This option disables the "Virtualisation" feature for this executable on Windows Vista. Virtualisation caused file and registry access to be redirected to a special user folder if the user does not have the needed rights to do the operation. (this is done for compatibility with older programs)
Note that this redirection is done without notifying the user which can lead to some confusion if he tries to find saved files on the filesystem. Because of this, it is recommended to disable this feature if the program complies with the Windows Vista file/registry access rules.

chapitre Outils de déboguage/Le visualisateur de mémoire
Il y a une ligne en anglais

If the memory area is valid for viewing, it will be displayed in the area below. If parts of the area are not valid for reading, you will get an error message. La façon de présenter le contenu de la mémoire peut être défini grâce à la liste déroulante située en bas à gauche. Les modes suivants sont disponibles:

[comtois]

Pour les traductions ça m'arrangerait si quelqu'un en propose une .

Je ferai les modifs ce soir, j'ai vu qu'il y avait encore le moniteur CPU dans l'aide, je le supprime ce soir

[comtois]

Si un utilisateur de vista pouvait me confirmer que c'est correct ?

Cette option désactive la «virtualisation» de cet exécutable sur Windows Vista. La Virtualisation
provoque la redirection des fichiers et les accès au Registre vers un dossier utilisateur si l'utilisateur n'a pas
les droits nécessaires à l'opération. (ce qui permet de conserver la compatibilité avec d'anciens programmes)

Notez que cette redirection se fait sans en aviser l'utilisateur ce qui peut conduire à une certaine confusion si
il essaye de trouver les fichiers sauvegardés sur le système de fichiers. Pour cette raison, il est recommandé de
désactiver cette fonctionnalité si le logiciel est conforme avec les règles d'accès aux fichiers ou du registre de Vista.

Je viens de voir qu'il y a encore plein de trucs en anglais dans ce fichier !!

[LavaLava]

Salut,
je viens de me faire piéger par la fonction ComboBoxGadget.
La page d'explication et l'exemple de l'aide de PB 4.30 ne sont pas à jour. J'ai compris le problème par l'historique de la nouvelle version.

Autre chose,dans la fonction runprogram il est noté

Les commandes suivantes peuvent être utilisées lorsque l'option #PB_Program_Open est spécifiée:
...

Ne faudrait'il pas spécifier dans chacune de ces commandes qu'il faut avoir préalabrlement utiliser RunProgram( .. ,#PB_Program_Open ) avant de les appeler ?

Merci pour votre travail.

[Anonyme2]

Ca serait bien d'avoir les explications sur les tableaux de la rubrique structure, également dans le chapitre des tableaux.

rubrique structure

Note : Un tableau statique dans une structure ne se comporte pas de la même façon qu'un tableau défini avec la commande Dim. Ceci pour être conforme au format de structures en C/C++ (pour permettre un portage direct des structures de l'API). Ce qui signifie que a[2] assignera un tableau
de 0 à 1 (deux éléments) alors que Dim a(2) assignera un tableau de 0 à 2 (trois éléments).