Nessuno tranne te si preoccupa dei numeri di revisione CVS; sono un artefatto interno del meccanismo che usi (se hai usato Git, gli ID di revisione sarebbero interamente diversi e senza una sequenza ovvia).
Invece, dovresti definire le versioni in termini di versioni dove dici "questa è una configurazione del codice che ha senso usare nel suo complesso", ed è proprio quelle versioni che dovresti fare riferimento alla documentazione, specialmente per cose come le avvertenze sulla deprecazione. Dopotutto, saranno quelle versioni che i consumatori dell'API - le persone che saranno i consumatori degli avvisi di deprecazione e il software che creano - vedranno. In termini di sistema di controllo delle revisioni, le versioni di rilascio sono il genere di cose che di solito è meglio modellare con un tag o un'etichetta.
Se non hai ancora fatto un rilascio, non devi deprecare nulla. Se hai una versione precedente, l'avviso di rimozione dovrebbe menzionare la versione di rilascio successiva . (Non dovrebbe menzionare la versione appena rilasciata, che dovrebbe essere considerata un artefatto statico.)