1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90
|
.TH SYNC-CONTENT 1 "December 2025" "sync-content" "User Commands"
.SH NAME
sync-content \- synchronize directory, file, and symlink structure
.SH SYNOPSIS
.B sync-content
.RB [ -h ]
.I from
.I to
.SH DESCRIPTION
The
.B sync-content
command synchronizes the file, directory, and symbolic link structure from
the source path
.I from
to the destination path
.I to.
Only entries that differ between the source and destination are updated.
Entries that are identical are skipped to minimize unnecessary work.
The operation is one-way: changes flow from
.I from
to
.I to.
No deletions or modifications are performed in the source.
.SH OPTIONS
.TP
.B -h
Display a help message summarizing usage, arguments, and options, then exit.
.SH FEATURES
.TP
.B Efficient synchronization
Only changed or missing entries are copied, reducing I/O and runtime.
.TP
.B Structure preservation
Directories, regular files, and symbolic links are replicated exactly.
.TP
.B Non-destructive
Existing matching files in the destination are left untouched.
.SH ARGUMENTS
.TP
.I from
The source directory whose contents will be synchronized.
.TP
.I to
The target directory that will receive updated or missing entries.
.SH EXIT STATUS
.TP
.B 0
Successful completion.
.TP
.B non-zero
An error occurred during synchronization.
.SH EXAMPLES
.TP
Synchronize the contents of ./src into ./backup:
.PP
.RS
.nf
sync-content ./src ./backup
.fi
.RE
.SH NOTES
.B sync-content
is a lightweight JavaScript implementation inspired by
.BR rsync (1),
providing a simplified one-way synchronization mechanism suitable for
development workflows and tooling environments.
It is used internally by
.B tshy(1)
a javascript enhanced builder
to replicate directory structures and ensure consistent project layouts.
The command does not remove files or directories that exist in the
destination but not in the source.
.SH SEE ALSO
rsync(1), cp(1), find(1), tshy(1)
.SH AUTHOR
Written by Bastien Roucariès from Isaac Z. Schlueter documentation
|