summaryrefslogtreecommitdiffstats
path: root/git-fast-import.html
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2018-05-23 16:07:42 +0900
committerJunio C Hamano <gitster@pobox.com>2018-05-23 16:07:42 +0900
commitb9d9d90d180cf21baeeb16bd89828d25c7901470 (patch)
treea40241052af8d4f5543b66581e3f0235cfae0af3 /git-fast-import.html
parentccb8252b46bfba5daf0cfcedaf0f9d2e14ba356f (diff)
downloadgit-htmldocs-b9d9d90d180cf21baeeb16bd89828d25c7901470.tar.gz
Autogenerated HTML docs for v2.17.0-775-ge144d
Diffstat (limited to 'git-fast-import.html')
-rw-r--r--git-fast-import.html27
1 files changed, 14 insertions, 13 deletions
diff --git a/git-fast-import.html b/git-fast-import.html
index fe8e69b71..817fe0998 100644
--- a/git-fast-import.html
+++ b/git-fast-import.html
@@ -1,9 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
-<meta name="generator" content="AsciiDoc 8.6.9" />
+<meta name="generator" content="AsciiDoc 8.6.10" />
<title>git-fast-import(1)</title>
<style type="text/css">
/* Shared CSS for AsciiDoc xhtml11 and html5 backends */
@@ -970,7 +971,7 @@ fastimport.unpackLimit
</div>
</div>
<div class="sect1">
-<h2 id="_performance">Performance</h2>
+<h2 id="_performance">PERFORMANCE</h2>
<div class="sectionbody">
<div class="paragraph"><p>The design of fast-import allows it to import large projects in a minimum
amount of memory usage and processing time. Assuming the frontend
@@ -986,7 +987,7 @@ destination Git repository (due to less IO contention).</p></div>
</div>
</div>
<div class="sect1">
-<h2 id="_development_cost">Development Cost</h2>
+<h2 id="_development_cost">DEVELOPMENT COST</h2>
<div class="sectionbody">
<div class="paragraph"><p>A typical frontend for fast-import tends to weigh in at approximately 200
lines of Perl/Python/Ruby code. Most developers have been able to
@@ -997,7 +998,7 @@ an ideal situation, given that most conversion tools are throw-away
</div>
</div>
<div class="sect1">
-<h2 id="_parallel_operation">Parallel Operation</h2>
+<h2 id="_parallel_operation">PARALLEL OPERATION</h2>
<div class="sectionbody">
<div class="paragraph"><p>Like <em>git push</em> or <em>git fetch</em>, imports handled by fast-import are safe to
run alongside parallel <code>git repack -a -d</code> or <code>git gc</code> invocations,
@@ -1017,7 +1018,7 @@ is not necessary for an initial import into an empty repository.</p></div>
</div>
</div>
<div class="sect1">
-<h2 id="_technical_discussion">Technical Discussion</h2>
+<h2 id="_technical_discussion">TECHNICAL DISCUSSION</h2>
<div class="sectionbody">
<div class="paragraph"><p>fast-import tracks a set of branches in memory. Any branch can be created
or modified at any point during the import process by sending a
@@ -1036,7 +1037,7 @@ between branches.</p></div>
</div>
</div>
<div class="sect1">
-<h2 id="_input_format">Input Format</h2>
+<h2 id="_input_format">INPUT FORMAT</h2>
<div class="sectionbody">
<div class="paragraph"><p>With the exception of raw file data (which Git does not interpret)
the fast-import input format is text (ASCII) based. This text based
@@ -2136,7 +2137,7 @@ stream.</p></div>
</div>
</div>
<div class="sect1">
-<h2 id="_responses_to_commands">Responses To Commands</h2>
+<h2 id="_responses_to_commands">RESPONSES TO COMMANDS</h2>
<div class="sectionbody">
<div class="paragraph"><p>New objects written by fast-import are not available immediately.
Most fast-import commands have no visible effect until the next
@@ -2167,7 +2168,7 @@ performing writes to fast-import that might block.</p></div>
</div>
</div>
<div class="sect1">
-<h2 id="_crash_reports">Crash Reports</h2>
+<h2 id="_crash_reports">CRASH REPORTS</h2>
<div class="sectionbody">
<div class="paragraph"><p>If fast-import is supplied invalid input it will terminate with a
non-zero exit status and create a crash report in the top level of
@@ -2271,7 +2272,7 @@ END OF CRASH REPORT</code></pre>
</div>
</div>
<div class="sect1">
-<h2 id="_tips_and_tricks">Tips and Tricks</h2>
+<h2 id="_tips_and_tricks">TIPS AND TRICKS</h2>
<div class="sectionbody">
<div class="paragraph"><p>The following tips and tricks have been collected from various
users of fast-import, and are offered here as suggestions.</p></div>
@@ -2366,7 +2367,7 @@ has been processed.</p></div>
</div>
</div>
<div class="sect1">
-<h2 id="_packfile_optimization">Packfile Optimization</h2>
+<h2 id="_packfile_optimization">PACKFILE OPTIMIZATION</h2>
<div class="sectionbody">
<div class="paragraph"><p>When packing a blob fast-import always attempts to deltify against the last
blob written. Unless specifically arranged for by the frontend,
@@ -2395,7 +2396,7 @@ final packfile size (30-50% smaller can be quite typical).</p></div>
</div>
</div>
<div class="sect1">
-<h2 id="_memory_utilization">Memory Utilization</h2>
+<h2 id="_memory_utilization">MEMORY UTILIZATION</h2>
<div class="sectionbody">
<div class="paragraph"><p>There are a number of factors which affect how much memory fast-import
requires to perform an import. Like critical sections of core
@@ -2469,7 +2470,7 @@ memory footprint (less than 2.7 MiB per active branch).</p></div>
</div>
</div>
<div class="sect1">
-<h2 id="_signals">Signals</h2>
+<h2 id="_signals">SIGNALS</h2>
<div class="sectionbody">
<div class="paragraph"><p>Sending <strong>SIGUSR1</strong> to the <em>git fast-import</em> process ends the current
packfile early, simulating a <code>checkpoint</code> command. The impatient
@@ -2495,7 +2496,7 @@ compression.</p></div>
<div id="footer">
<div id="footer-text">
Last updated
- 2018-01-26 15:11:04 PST
+ 2018-05-23 16:06:29 JST
</div>
</div>
</body>