Bluefish offre un grand nombre de fonctionnalités et permet, ainsi, à l'utilisateur d'adapter l'éditeur de texte au gré de ses besoins. Ce manuel s'adresse à la fois aux novices et aux utilisateurs chevronnés ; c'est une documentation complète pour tout un chacun.
Nous recommandons à ceux qui utilisent Bluefish pour la première fois la lecture des Partie 1, « Récupération et installation de Bluefish » et Partie 2, « Utilisation de Bluefish » . Elles donnent des informations générales sur Bluefish, expliquent comment l'installer, présentent ses fonctionnalités principales et donnent la liste des raccourcis disponibles.
La Partie 3, « Développement de Bluefish » s'adresse aux testeurs et développeurs. Elle explique comment déboguer Bluefish, contient la liste de la quasi-totalité des fonctionnalités, indique le style de formatage du code et contient la liste de tous les fichiers sources.
Ce manuel s'adresse à l'utilisateur final. C'est pourquoi nous avons abordé les sujets de manière simple et détaillée chaque fois que cela était possible. Vous trouverez ci-dessous les conventions typographiques utilisées dans ce manuel :
Les URL sont indiquées ainsi que suit : http://bluefish.openoffice.nl
Les raccourcis clavier comme ceci : Ctrl-S
Les options de menu comme cela : . Néanmoins, la plupart des menus de Bluefish sont relativement complexes. Dans les sous-menus, les options sont séparées par une flèche, comme ceci : → (Ctrl-O). Le raccourci clavier par défaut est indiqué entre parenthèses.
On utilise une police Monotype pour distinguer les saisies utilisateur, comme par exemple la saisie de commande à l'invite dans un terminal :
$toto -tata | titi -l![[Note]](imgs/note.png)
On ne doit pas saisir le caractère
$. Il n'est là que pour simuler l'invite. Dans le cas où la commande doit être lancée avec les droits de super-utilisateur, l'invite est simulée par le caractère#.
Enfin, si vous trouvez des erreurs ou omissions dans le manuel, envoyez un rapport de bogue de documentation.