Les scripts shell utilisent le symbole dièse (#) pour les commentaires :
#!/bin/bash
## This is a comment in a shell script
echo "LabEx Linux Tutorial"
: '
This is a multi-line comment
in bash script
'
Python prend en charge les commentaires sur une seule ligne et les commentaires multilignes :
## Single-line comment in Python
'''
Multi-line comment
Using triple quotes
Supported in Python files
'''
def example_function():
"""
Docstring comment
Provides function documentation
"""
pass
Les fichiers C et C++ prennent en charge plusieurs styles de commentaires :
// Single-line comment
/*
* Multi-line comment
* Spanning multiple lines
*/
/**
* Documentation comment
* Used for generating API docs
*/
graph TD
A[Comment Placement] --> B[Above Code Block]
A --> C[Inline Comments]
A --> D[End of Code Line]
A --> E[Function/Class Header]
Emplacement |
Recommandation |
En-tête du fichier |
Décrire le but du fichier, l'auteur, la date |
En-tête de fonction |
Expliquer le but de la fonction, les paramètres |
Logique complexe |
Expliquer pourquoi, pas quoi |
Code temporaire |
Marquer avec TODO ou FIXME |
## TODO: Implement error handling
## FIXME: Resolve performance issue
## NOTE: Requires further investigation
Les fichiers de configuration dans Linux utilisent souvent des styles de commentaires spécifiques :
## This is a comment in configuration files
; Alternative comment style
## LabEx recommends clear, concise comments
Génération automatique de documentation
graph LR
A[Documentation Tools] --> B[Doxygen]
A --> C[Sphinx]
A --> D[JavaDoc]
#!/usr/bin/env python3
"""
Linux File Comments Tutorial
Created by LabEx Developer
Date: Current Year
"""
def calculate_total(items):
"""
Calculate total cost of items
Args:
items (list): List of item prices
Returns:
float: Total cost
"""
## Validate input
if not items:
return 0.0 ## Handle empty list
return sum(items) ## Calculate total
En maîtrisant ces techniques de commentaires, les développeurs peuvent créer des fichiers Linux plus lisibles et plus facilement maintenables dans différents langages de programmation.