.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "SYD\-EMACS" "1" "2026\-09\-01"
.PP
.SH NAME
.PP
\fBsyd\-emacs\fR \- Convenience wrapper to run Emacs under Syd
.PP
.SH SYNOPSIS
.PP
\fBsyd\-emacs\fR \fI[command\-line switches]\fR \fI[files.\&.\&.\&]\fR
.PP
.SH DESCRIPTION
.PP
\fBsyd\-emacs\fR is a convenience wrapper to run Emacs under Syd.\&
All command\-line arguments are passed directly to \fIemacs\fR(1).\&
.PP
.SH FILES
.PP
.TS
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx.
T{
/dev/syd.\&el
T}	T{
Emacs Lisp \fIsyd\fR(2) API library.\&
T}
T{

T}	T{
Access assumes sandbox lock is accessible, ie "lock:off" or "lock:exec".\&
T}
T{
\(ti/.\&emacs.\&d/init.\&syd\-3
T}	T{
Emacs Syd profile, if this file does not exist, the "lib" profile is used instead.\&
T}
T{

T}	T{
The "lib" profile turns all sandboxing off and sets "lock:exec" to allow access to the virtual file "/dev/syd.\&el".\&
T}
T{

T}	T{
If you do not want to turn all sandboxing off, you'\&re encouraged to configure a profile with this file.\&
T}
T{

T}	T{
Ensure to add "lock:exec" in the end so that the initial \fIemacs\fR(1) process can access the sandbox to load "/dev/syd.\&el".\&
T}
T{

T}	T{
Ensure to call "(syd\-lock :lock\-on)" from within \fIemacs\fR(1) when you'\&re done configuring \fIsyd\fR(1) using the \fIsyd\fR(2) API.\&
T}
T{

T}	T{
If you do not want to allow access to the sandbox lock, you'\&re encouraged to call \fIsyd\fR(1) manually with \fIemacs\fR(1).\&
T}
T{

T}	T{
This is just a convenience wrapper.\&
T}
T{
\(ti/.\&emacs.\&d/syd.\&log
T}	T{
Emacs Syd log file, access violations are logged to this file.\&
T}
T{

T}	T{
\fIsyd\-emacs\fR(1) opens this file, and sets \fBSYD_LOG_FD\fR environment variable to the value of the file descriptor.\&
T}
T{

T}	T{
The file is opened for create+append\-only.\&
T}
.TE
.sp 1
.SH SEE ALSO
.PP
\fIsyd\fR(1), \fIsyd\fR(2), \fIsyd\fR(5), \fIemacs\fR(1)
.PP
\fBsyd\fR homepage: https://sydbox.\&exherbo.\&org/
.PP
.SH AUTHORS
.PP
Maintained by Ali Polatel.\& Up\-to\-date sources can be found at
https://gitlab.\&exherbo.\&org/sydbox/sydbox.\&git and on Radicle at
rad:z38HCnbmcDegA2BMxuPaPRPMdp6wF.\& Bugs/patches can be submitted to
https://gitlab.\&exherbo.\&org/groups/sydbox/\-/issues.\& Discuss in #sydbox on Libera
Chat or in #sydbox:mailstation.\&de on Matrix.\&