aeimport - Online nel cloud

PROGRAMMA:

NOME

aeimport - importa il repository esterno in Aegis

SINOSSI

aeimport [ opzione...] cognome
aeimport -Aiuto
aeimport -Versione

DESCRIZIONE

Il aeimport comando viene utilizzato per creare un nuovo progetto e popolarlo importando a
repository esterno (come RCS o CVS) senza perdita della cronologia del progetto.

Nota: a meno che non specifichi una versione (vedi il -versione opzione, sotto) questo comando
per impostazione predefinita creerà rami per supportare la versione 1.0. Se hai scoperto anche questo
tardi, non tutto è perduto: puoi usare il aenbru(1) comando per sbarazzarsi dei rami tu
non volevo.

elenco
La directory del progetto, in cui la linea di base e la cronologia del progetto, lo stato e il cambiamento
i dati vengono conservati, verranno creati in questo momento. Se la -Directory l'opzione non è data, il
la directory del progetto verrà creata nella directory specificata da default_project_‐
campo directory di aeuconf(5), o se non è impostato nella directory home dell'utente corrente; in entrambe
caso con lo stesso nome del progetto.

STAFF
Il progetto viene creato con l'utente e il gruppo correnti come utente e gruppo proprietari. Il
l'utente corrente è un amministratore del progetto. Il progetto non ha altro
amministratori (usare aena(1) per aggiungere altro).

Il progetto avrà tutti i nomi utente trovati nei file di cronologia (vedi colpo) installati come
sviluppatori, revisori e integratori. Questo è probabilmente troppo ampio, ma abbastanza accurato
riproduce i permessi spalancati trovati nella maggior parte dei repository e vorrai usare
aerd(1) aerv(1) e aereo(1) come appropriato per vagliare questo elenco.

Se viene trovato un solo nome, il progetto verrà impostato su "developers_may_review = true;"
altrimenti sarà falso (vedi aepattr(5) per maggiori informazioni). Utilizzo aep(1) cambiare
questo se vuoi un'impostazione diversa.

L'umask del progetto è derivato dall'umask dell'utente corrente, ma è stato modificato per garantire
che i membri del gruppo avranno accesso e che solo il proprietario del progetto avrà la possibilità di scrivere
accesso. In generale, il meglio del progetto è non è un di proprietà di un account con qualsiasi altro
ruolo, poiché ciò impedisce un'intera classe di errori "oops, pensavo di essere da qualche altra parte".

I comandi della cronologia del progetto (vedi aepconf(5) per maggiori informazioni) sono impostati su quelli
adatto per RCS. Il comando build è impostato su "exit 0"; devi impostarlo su qualcosa
adatto. La farm di collegamento simbolico è attivata.

Pointer
Il puntatore del progetto verrà aggiunto al primo elemento del percorso di ricerca, o se nessun percorso
è impostato. Se questo non è appropriato, usa il -Biblioteca opzione per impostare esplicitamente il desiderato
Posizione. Vedi il -Biblioteca opzione per ulteriori informazioni.

In alternativa, disattiva la variabile d'ambiente AEGIS_PATH per aggiungere il progetto al globale
elenco progetti.

Versione
Puoi specificare la versione del progetto in due modi:

1. Il numero di versione può essere implicito nel nome del progetto, nel qual caso la versione
i numeri verranno cancellati. Ad esempio, "aeimport -p example.1.2" creerà a
progetto denominato “esempio” con ramo numero 1 creato e ramo secondario 2 del ramo 1
creato.

2. Il numero di versione può essere indicato esplicitamente, nel qual caso sarà suddiviso per
numeri di filiale. Ad esempio, "aeimport -p example -version 1.2" creerà un progetto
chiamato “esempio” con il ramo numero 1 creato e il ramo secondario 2 del ramo 1 creato.

In ogni caso, questi rami possono essere nominati ovunque venga dato un nome di progetto, come ad esempio
“-p esempio.1” e “-p esempio-1.2”. Il carattere di punteggiatura effettivo non è importante.

Potresti avere qualsiasi profondità di numeri di versione che ti piace. Entrambi i metodi per specificare la versione
i numeri possono essere usati e saranno combinati. Se non vuoi nessun numero di versione,
uso -versione con un solo trattino come argomento, come in "-version -"

Se non viene fornito alcun numero di versione, esplicitamente o implicitamente, viene utilizzata la versione 1.0.

Progetto elenco Posizione
Per favore, Nota: Aegis consulta anche il file system sottostante, per determinare la sua nozione di
dimensione massima del file. Dove la dimensione massima del file del file system è inferiore a
lunghezza_massima_nome_file, vince il filesystem. Questo può succedere, ad esempio, quando sei
usando il file system Linux UMSDOS, o quando hai un NFS montato un vecchio V7
file system. Collocamento lunghezza_massima_nome_file a 255 in questi casi non altera il
fatto che i limiti dei file system sottostanti sono molto più piccoli (rispettivamente 12 e 14).

Se le tue directory di sviluppo (o l'intero progetto) sono su filesystem con nome file
limitazioni, o una parte delle costruzioni eterogenee ha luogo in un tale ambiente,
aiuta a dire ad Aegis cosa sono (usando il progetto config campi del file) in modo che tu
non incorrere nella situazione in cui il progetto si basa sul più permissivo
ambienti, ma fallisce con misteriosi errori negli ambienti più limitati.

Se le tue directory di sviluppo si trovano regolarmente su un filesystem Linux UMSDOS, dovresti
probabilmente sarebbe meglio impostare dos_nomefile_richiesto = vero, e anche cambiando il
sviluppo_directory_template campo. Sviluppo eterogeneo con varie finestre
anche gli ambienti possono richiederlo.

freschi PROCESSO

La maggior parte dei sistemi di versione dei file non funziona utilizzando le serie di modifiche. Per importare tale
repository in Aegis è necessario "scoprire" questi set di modifiche. Il seguente
si adottano misure:

1.
La rubrica (dirpath) fornito sulla riga di comando e tutte le directory sottostanti sono
scansionati per i file appropriati (ad esempio, RCS e CVS usano file con un suffisso “,v”).
Questi file vengono letti per ottenere la cronologia del file.
Se hai utilizzato un suffisso di file non standard, aeimport non sarà in grado di trovare il
File.
Se hai più di un modulo nel tuo repository CVS, aeimport non lo fa (ancora)
comprendere il file CVSROOT/modules. Puntare aeimport all'intero CVSROOT può
produrre un risultato inaspettatamente grande.

2.
I file di cronologia scoperti nel passaggio precedente vengono copiati nella posizione utilizzata da
Egida. A differenza di altri strumenti, Aegis ha un repository per progetto, piuttosto che tutti
progetti che condividono lo stesso repository.
Ciò significa anche che Aegis non modificherà i file di cronologia originali. In particolare,
se l'importazione produce risultati imprevisti, è sufficiente rimuovere il progetto (vedi aermpr(1) per
maggiori informazioni) e ricominciare.
Non è possibile lasciare tutti i file della cronologia sotto, ad esempio, $CVSROOT e avere Aegis
indicarli.

3.
Per ogni utente citato nelle varie cronologie dei file, vengono esaminate le marcature temporali per
trova gruppi di file che sono stati commessi più o meno nello stesso momento. File modificati
entro 1 minuto l'uno dall'altro sono considerati un gruppo.
I file cambiano entro un minuto, ma da utenti diversi, sono non è un considerato un gruppo.
Questo di solito non rappresenta un problema poiché gli sviluppatori lavorano principalmente da soli. In rari casi
dove gli sviluppatori lavorano insieme, solo uno di loro esegue il commit.
In alcuni casi la finestra temporale potrebbe essere troppo ampia e potrebbero essere apportate modifiche molto piccole
visto come un insieme di modifiche più ampio. In pratica, questo non è molto comune.

4.
I gruppi di file sono memorizzati nel database Aegis come modifiche completate (cioè come se
aeipass(1) è già stato eseguito). La descrizione del cambiamento è la concatenazione di tutti
i commenti unici trovati allegati alle relative versioni dei file. Il timestamp utilizzato
poiché la modifica è l'ultimo timestamp di qualsiasi file nel gruppo.
Ci sono momenti in cui piccoli errori tipografici tra i commenti sui file si traducono in tempi più lunghi-
descrizioni delle modifiche del previsto. Questo può essere corretto con aeca(1) o tkaeca(1) se
desiderato. Ci sono anche momenti in cui è vero il contrario: alcuni file non hanno commenti su
tutto, e la descrizione risultante è tutt'altro che utile.

5.
I tag vengono trasformati in nomi delta trasferendo i nomi delta dai file che sono
a cui sono collegati, ai set di modifiche a cui sono collegati. Quando un tag sembrerebbe essere
allegato a più di una modifica, è allegato solo all'ultima modifica.
Nell'uso comune, i tag hanno uno scopo simile ai numeri delta di Aegis. Loro sono
tutto (tipicamente) applicato in un singolo comando CVS, in modo che un particolare rilascio possa
essere ricreato in seguito. Tuttavia, poiché ogni file avrà una versione diversa e
ognuno avrà avuto la sua ultima versione inclusa in vari set di modifiche casuali.
I tag sono usati anche per altre cose. Il metodo qui fornito è semplicemente un'ipotesi, ma è
uno che funziona abbastanza bene.

Una volta che aeimport ha completato l'importazione di un progetto, sarai in grado di esaminare i risultati
usando il ael storia_progetto e ael modifica_dettagli comandi. (Vedere ael(1) per di più
informazione.)

Limiti
Il programma aeimport è tutt'altro che perfetto. Ci sono una serie di limitazioni note.

· Al momento, non è disponibile alcun supporto per la ramificazione. (Appena ho capito come fare
discernere la radice di un ramo tra file accoppiati in modo lasco, lo implementerò. Idee
e/o contributi al codice sono benvenuti.)

· Attualmente sono compresi solo i formati RCS e SCCS. Dovrebbe essere diretto a
aggiungere il supporto per formati aggiuntivi in ​​futuro. Solo il passaggio 1 del processo di cui sopra
richiede attenzione, il resto è neutrale rispetto al formato del file.

· Non c'è supporto per i moduli CVS, e deve esserlo.

· Non è possibile specificare la dimensione della finestra temporale utilizzata per determinare le serie di modifiche. Il tempo lo dirà
se questo è necessario, ma sorge la domanda: come farai a sapere quale dimensione della finestra?
è necessario per utilizzare l'opzione.

· Non puoi importare un repository CVS in un progetto esistente. Puoi solo creare un nuovo
progetto da un repository CVS.

· Non puoi importare un repository CVS remoto.

VERSIONI

Si intendono le seguenti opzioni:

-Directory sentiero
Questa opzione può essere utilizzata per specificare quale directory deve essere utilizzata. È un errore
se l'utente corrente non dispone delle autorizzazioni appropriate per creare la directory
percorso dato. Questo deve essere un percorso assoluto.

Attenzione: se stai usando un automounter non usare `pwd` per fare un assoluto
percorso, di solito dà la risposta sbagliata.

-Formato Nome
Questa opzione può essere utilizzata per specificare quale formato di cronologia viene importato. Il
si intendono i seguenti formati:

Il formato RCS Release Control System è in circolazione da un po' di tempo. è
il formato sottostante CVS (Concurrent Version System). Questo è il
default se non viene specificato alcun nome di formato.
Nota: Tu devono obbligatoriamente: avere RCS installato prima di eseguire aeimport se usi questo
format, perché i comandi RCS verranno eseguiti durante il processo di importazione. Il
l'importazione fallirà se RCS non è installato. Puoi trovare un software gratuito
implementazione su ftp.gnu.org o un mirror locale.

SCCS Source Code Control System è uno dei primi sistemi di versione Unix.
(Mi è stato detto che questo è il formato alla base di BitKeeper.)
Nota: Tu devono obbligatoriamente: avere SCCS installato prima di eseguire aeimport se usi
questo formato, poiché i comandi SCCS verranno eseguiti durante il processo di importazione.
L'importazione avrà esito negativo se SCCS non è installato. Lo stupido compatibile con GNU
Source Control (CSSC) è un'implementazione freeware di SCCS e potrebbe essere
Trovato a ftp://alpha.gnu.org/gnu/CSSC/

-Biblioteca abspatico
Questa opzione può essere usata per specificare una directory in cui cercare lo stato globale
file e file di stato utente. (Vedere aegstate(5) e aeustato(5) per di più
informazioni.) Sulla riga di comando possono essere presenti diverse opzioni di libreria e
sono ricercati nell'ordine dato. In allegato a questo percorso di ricerca esplicito ci sono i
directory specificate dal PERCORSO_AEGIS variabile d'ambiente (separata da due punti),
e infine, /usr/local/lib/egis è sempre cercato. Tutti i percorsi specificati,
o sulla riga di comando o nel PERCORSO_AEGIS variabile d'ambiente, deve essere
assoluto.

-Elenco
Questa opzione può essere utilizzata per ottenere un elenco di soggetti idonei per questo comando.
L'elenco potrebbe essere più generale del previsto.

-Progetto Nome
Questa opzione può essere utilizzata per selezionare il progetto di interesse. quando no -Progetto
l'opzione è specificata, il AEGIS_PROGETTO viene consultata la variabile di ambiente. Se
che non esiste, l'utente $HOME/.aegisrc il file viene esaminato per un valore predefinito
campo del progetto (vedi aeuconf(5) per maggiori informazioni). Se ciò non esiste,
quando l'utente sta lavorando solo sulle modifiche all'interno di un singolo progetto, il progetto
nome predefinito su quel progetto. Altrimenti è un errore.

-Aiuto
Questa opzione può essere utilizzata per ottenere maggiori informazioni su come utilizzare il aeimport
.

-Versione numero
Questa opzione può essere utilizzata per specificare il numero di versione per il progetto. Versione
i numeri sono implementati come rami. Usa un singolo trattino ("-") come argomento se
non vuoi creare rami di versione.

Vedi anche egida(1) per le opzioni comuni a tutti i comandi aegis.

Tutte le opzioni possono essere abbreviate; l'abbreviazione è documentata come le lettere maiuscole,
tutte le lettere minuscole ei caratteri di sottolineatura (_) sono facoltativi. Devi usare consecutivo
sequenze di lettere facoltative.

Tutte le opzioni non fanno distinzione tra maiuscole e minuscole, puoi digitarle in maiuscolo o minuscolo o a
combinazione di entrambi, il caso non è importante.

Ad esempio: gli argomenti "-project, "-PROJ" e "-p" sono tutti interpretati come il
-Progetto opzione. L'argomento "-prj" non sarà compreso, perché consecutivo
caratteri facoltativi non sono stati forniti.

Opzioni e altri argomenti della riga di comando possono essere mescolati arbitrariamente sulla riga di comando,
dopo i selettori di funzione.

I nomi lunghi delle opzioni GNU sono compresi. Poiché tutti i nomi delle opzioni per aeimport sono lunghi,
questo significa ignorare l'extra '-'. Il "--opzione=APPREZZIAMO"convenzione è anche
inteso.

EXIT STATUS

Il aeimport il comando uscirà con uno stato di 1 su qualsiasi errore. Il aeimport command
uscirà con lo stato 0 solo se non ci sono errori.

AMBIENTE VARIABILI

See egida(1) per un elenco di variabili d'ambiente che possono influenzare questo comando. Vedere
aepconf(5) per i file di configurazione del progetto specifico del progetto campo per come impostare
variabili d'ambiente per tutti i comandi eseguiti da Aegis.

COPYRIGHT

aeimport versione 4.24.3.D001
Diritto d'autore (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Peter Miller

Il programma aeimport viene fornito con ASSOLUTAMENTE NESSUNA GARANZIA; per i dettagli utilizzare il 'aeimport
-Versione Licenza' comando. Questo è un software gratuito e puoi ridistribuirlo
a determinate condizioni; per i dettagli utilizzare il 'aeimport -Versione Licenza' comando.

Usa aeimport online utilizzando i servizi onworks.net